inbox zero

받은 편지함 제로

받은편지함이 0이 되는 속도로 빠르게 도달할 수 있는 오픈 소스 이메일 앱입니다.
웹사이트 · 불일치 · 문제 · 칸반

에 대한

Inbox Zero는 AI 지원을 통해 받은 편지함 0에 빠르게 도달하도록 돕는 오픈 소스 이메일 앱입니다.

데모 비디오

주요 특징

• 뉴스레터 클리너: 뉴스레터를 쉽게 관리하고 구독 취소할 수 있습니다.
• AI Assistant: 일반 텍스트 프롬프트 규칙을 기반으로 이메일을 자동 응답, 보관, 라벨 지정 및 전달합니다.
• 콜드 이메일 차단기: 콜드 이메일을 자동으로 차단합니다.
• 이메일 분석: 일일, 주간, 월간 통계를 통해 이메일 활동을 추적합니다.
• 새 보낸 사람: 새로운 스팸 보낸 사람을 식별하고 차단합니다.
• 답장되지 않은 이메일: 응답을 기다리는 이메일을 추적합니다.
• 대용량 이메일 찾기: 대용량 이메일을 찾아 삭제하여 공간을 확보하세요.

다음으로 제작됨

• Next.js
• 순풍 CSS
• shadcn/ui
• 프리즈마
• 타이니버드
• 업스태시
• 터보

기능 요청

기능을 요청하려면 GitHub 문제를 엽니다. GitHub 계정이 없으면 여기에서 기능을 요청할 수 있습니다. 아니면 Discord에 참여하세요.

개발자를 위한 시작하기

프로젝트에 기여

여기에서 공개 Kanban을 사용할 수 있습니다. Discord에 참여하여 작업에 대해 토론하고 진행 중인 작업을 확인하세요.

요구사항

• Node.js >= 18.0.0
• pnpm >= 8.6.12
• Docker 데스크탑(선택사항)

설정

프로젝트를 설정하는 방법에 대한 비디오는 다음과 같습니다. 이 문서에 언급된 것과 동일한 단계를 다룹니다. 그러나 외부 서비스 설정에 대해 더 자세히 설명합니다.

필요한 외부 서비스는 다음과 같습니다.

• 오픈AI
• 구글 OAuth
• Google PubSub - 아래 설정 지침을 참조하세요.
• Upstash Redis - Docker Compose와 함께 일반 Redis를 사용할 수도 있습니다.
• Tinybird - 이 기능이 없어도 앱을 실행할 수 있지만 일부 기능은 비활성화됩니다.

데이터베이스로는 Postgres를 사용합니다.

docker-compose 사용하여 Postgres 및 Redis를 로컬에서 실행할 수 있습니다.

docker-compose up -d # -d will run the services in the background

나만의 .env 파일을 만듭니다.

cp apps/web/.env.example apps/web/.env
cd apps/web
pnpm install

새로 생성된 .env 에서 환경 변수를 설정합니다. apps/web/env.ts 에서 필수 변수 목록을 볼 수 있습니다.

필수 환경 변수:

• NEXTAUTH_SECRET -- 임의의 임의 문자열일 수 있습니다(빠른 보안 임의 문자열을 위해 openssl rand -hex 32 사용해 보십시오).
• GOOGLE_CLIENT_ID -- Google OAuth 클라이언트 ID입니다. 자세한 내용은 여기를 참조하세요
• GOOGLE_CLIENT_SECRET -- Google OAuth 클라이언트 비밀번호입니다. 자세한 내용은 여기를 참조하세요
• OPENAI_API_KEY -- OpenAI API 키입니다.
• UPSTASH_REDIS_URL -- Upstash의 Redis URL입니다.
• UPSTASH_REDIS_TOKEN -- Upstash의 Redis 토큰입니다.
• TINYBIRD_TOKEN - Tinybird 작업공간에 대한 관리 토큰(GCP us-east4 지역에서 인스턴스를 생성해야 합니다. 다른 지역을 선호하는 경우 .env 를 통해 변경할 수도 있습니다). Tinybird를 비활성화하기로 결정하면 분석 및 대량 구독 취소 기능이 비활성화됩니다. Tinybird를 비활성화하려면 NEXT_PUBLIC_DISABLE_TINYBIRD=true 설정하세요.

마이그레이션을 실행하려면 다음 안내를 따르세요.

pnpm prisma migrate dev

앱을 로컬에서 실행하려면 다음 안내를 따르세요.

pnpm run dev

또는 프로젝트 루트에서:

turbo dev

http://localhost:3000을 열어 브라우저에서 확인하세요. 자신을 관리자로 업그레이드하려면 http://localhost:3000/admin을 방문하세요.

Google OAuth 및 Gmail API 설정

Google Cloud Console에서 다음 범위를 사용 설정해야 합니다.

 https://www.googleapis.com/auth/userinfo.profile
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.settings.basic
https://www.googleapis.com/auth/contacts

Tinybird 설정

pipes 와 datasources 설정하려면 여기 지침을 따르세요.

선택 사항: Tinybird에도 AI 사용 통계를 저장하려면 /packages/tinybird-ai-analytics 에서 동일한 작업을 수행하세요.

실시간으로 이메일을 처리하려면 Google PubSub를 통해 푸시 알림을 설정하세요.

여기의 지침을 따르세요.

1. 주제 만들기
2. 구독 만들기
3. 주제에 대한 게시 권한 부여

환경 변수 GOOGLE_PUBSUB_TOPIC_NAME 을 설정합니다. 구독을 생성할 때 푸시를 선택하면 URL은 https://www.getinboxzero.com/api/google/webhook?token=TOKEN 또는 https://abc.ngrok-free.app/api/google/webhook?token=TOKEN 과 같아야 합니다. https://abc.ngrok-free.app/api/google/webhook?token=TOKEN 여기서 도메인은 귀하의 도메인입니다. .env 파일에서 GOOGLE_PUBSUB_VERIFICATION_TOKEN TOKEN 값으로 설정합니다.

개발에서 실행하려면 ngrok가 도움이 될 수 있습니다.

ngrok http 3000
# or with an ngrok domain to keep your endpoint stable (set `XYZ`):
ngrok http --domain=XYZ.ngrok-free.app 3000

그런 다음 Google PubSub 구독 대시보드에서 웹훅 엔드포인트를 업데이트하세요.

이메일 보기를 시작하려면 다음 페이지를 방문하세요. /api/google/watch/all