gravitchat

Gravit 팀의 내부 조회 챗봇. 팀 Notion(기획·회의록·문서)과 Jira(태스크·이슈)를 Gemini function calling으로 실시간 검색·조회해 한국어로 답한다.

빠른 시작

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env        # GEMINI_API_KEY 필수, NOTION/JIRA는 설정한 쪽만 도구 활성화

python -m api                       # CLI 채팅
uvicorn api.main:app --reload       # 웹 UI → http://localhost:8000
pytest                              # 테스트 (네트워크 불필요)

키 발급

항목	발급처
GEMINI_API_KEY	https://aistudio.google.com/apikey
NOTION_TOKEN	https://www.notion.so/my-integrations — 발급 후 조회할 페이지를 Integration에 연결해야 검색됨
JIRA_API_TOKEN	https://id.atlassian.com/manage-profile/security/api-tokens (JIRA_BASE_URL=https://<사이트>.atlassian.net, JIRA_EMAIL=계정 이메일)

배포 (Vercel)

npm i -g vercel && vercel

환경변수는 Vercel 프로젝트 설정에 등록한다. 팀 외부 노출을 막으려면 GRAVITCHAT_AUTH_ID / GRAVITCHAT_AUTH_PASSWORD를 설정해 공유 계정 로그인을 켠다.

아키텍처·작업 규칙은 CLAUDE.md 참고.