Show HN: 읽기 전용 인증 범위(read-only auth scopes)를 갖춘 오픈 소스 AI 워크플로우

Seer

비용 제어 및 인간의 감독(human oversight) 기능이 포함된 오픈 소스 워크플로우 빌더. Gmail, GitHub, Supabase와 같은 도구를 사용하여 AI 자동화(AI automations)를 구축하세요. 내장된 지출 한도(spend caps)와 승인 게이트(approval gates)가 제공됩니다.

빠른 시작 (Quick Start)

git clone https://github.com/seer-engg/seer
cd seer
cp .env.example .env
...

이것으로 끝입니다. http://localhost:5173을 열고 워크플로우(workflows) 구축을 시작하세요.

계정 생성이나 가입이 필요하지 않습니다. 앱은 기본적으로 로컬 모드(local mode)로 실행되며 로그인이 필요하지 않습니다.

실행 중인 서비스 (What's Running)

docker compose up 명령어로 모든 것을 시작합니다:

서비스	포트	설명
Frontend	localhost:5173	React 앱 (Vite 개발 서버)
...

API 문서는 http://localhost:8000/docs에서 확인할 수 있습니다.

설정 (Configuration)

예제 파일을 사용하여 .env를 생성하세요:

cp .env.example .env

필수 항목:

OPENAI_API_KEY=sk-...       # 또는 다른 LLM 제공업체 키

선택적 통합 (필요에 따라 추가):

ANTHROPIC_API_KEY=sk-ant-... # Claude 모델
OPENROUTER_API_KEY=sk-or-... # Kimi 및 기타 모델
GOOGLE_CLIENT_ID=...         # Google 통합 (Gmail, Sheets)
...

Docker가 DATABASE_URL 및 REDIS_URL을 자동으로 구성합니다.

인증 (Authentication)

인증 모드는 단일 환경 변수(env var)로 제어됩니다:

`AUTH_PROVIDER`	모드	사용 사례
`local` (기본값)	로그인 없음, 단일 사용자	셀프 호스팅(Self-hosted), 개인용
`clerk`	Clerk 인증 및 로그인	다중 사용자, 클라우드 배포

clerk 모드의 경우, CLERK_JWKS_URL, CLERK_ISSUER, CLERK_SECRET_KEY, VITE_CLERK_PUBLISHABLE_KEY도 설정해야 합니다. 자세한 내용은 .env.example을 참조하세요.

로컬 개발 (Docker 없이)

서비스를 직접 실행하는 것을 선호하는 경우:

# 인프라만 시작
docker compose up postgres valkey browserless -d

...

프로젝트 레이아웃 (Project Layout)

seer/
├── src/seer/              # Python 백엔드 (backend)
│   ├── api/               # FastAPI 라우터 (routers), 미들웨어 (middleware)
...

마이그레이션 (Migrations)

업데이트를 가져온 후 마이그레이션을 실행하세요:

# Docker
docker compose exec api uv run aerich upgrade

...

명령어 (Commands)

docker compose up              # 모든 서비스 시작
docker compose up -d           # 백그라운드에서 시작
docker compose logs -f api     # API 로그 추적
...

왜 Seer인가?

비용 제어 (Cost Controls) - 워크플로우별 지출 상한선 및 토큰 제한을 통해 AI 비용의 폭주를 방지합니다.
인간의 감독 (Human Oversight) - 중요한 작업에 대한 승인 게이트(Approval gates) 제공 및 완전한 감사 추적(Audit trails)을 지원합니다.
강력한 통합 (Powerful Integrations) - 최소한의 권한으로 Gmail, GitHub, Supabase, PostgreSQL과 연동됩니다.
AI 네이티브 (AI-Native) - 워크플로우 설계를 위한 채팅 인터페이스 및 지능형 에러 핸들링 (Error handling)을 제공합니다.
자체 호스팅 가능 (Self-Hostable) - git clone + docker compose up만으로 실행 가능하며, 별도의 계정이 필요하지 않습니다.

문서 (Documentation)

전체 문서 (Complete Documentation) - DeepWiki에서 상세 가이드, 아키텍처 및 예제를 확인하세요.

라이선스 (License)

AGPL-3.0 라이선스 - LICENSE를 참조하세요.

Insights