Open source email app to reach inbox zero fast.
Website
·
Discord
·
Issues
·
Kanban
Inbox Zero is an open-source email app whose goal is to help you reach inbox zero fast with AI assistance.
- Newsletter Cleaner: Easily manage and unsubscribe from newsletters.
- AI Assistant: Auto respond, archive, label, and forward emails based on plain text prompt rules.
- Cold Email Blocker: Automatically block cold emails.
- Email Analytics: Track your email activity with daily, weekly, and monthly stats.
- New Senders: Identify and block new spam senders.
- Unreplied Emails: Keep track of emails awaiting responses.
- Large Email Finder: Free up space by locating and deleting large emails.
To request a feature open a GitHub issue. If you don't have a GitHub account you can request features here. Or join our Discord.
We have a public Kanban available here. Join our Discord to discuss tasks and check what's being worked on.
- Node.js >= 18.0.0
- pnpm >= 8.6.12
- Docker desktop (optional)
Here's a video on how to set up the project. It covers the same steps mentioned in this document. But goes into greater detail on setting up the external services.
The external services that are required are:
- OpenAI
- Google OAuth
- Google PubSub - see set up instructions below
- Upstash Redis - you can also use regular Redis with the Docker Compose.
- Tinybird - you can run the app without this but some features then will be disabled.
We use Postgres for the database.
You can run Postgres & Redis locally using docker-compose
docker-compose up -d # -d will run the services in the backgroundCreate your own .env file:
cp apps/web/.env.example apps/web/.env
cd apps/web
pnpm installSet the environment variables in the newly created .env. You can see a list of required variables in: apps/web/env.ts.
The required environment variables:
NEXTAUTH_SECRET-- can be any random string (try usingopenssl rand -hex 32for a quick secure random string)GOOGLE_CLIENT_ID-- Google OAuth client ID. More info hereGOOGLE_CLIENT_SECRET-- Google OAuth client secret. More info hereOPENAI_API_KEY-- OpenAI API key.UPSTASH_REDIS_URL-- Redis URL from Upstash.UPSTASH_REDIS_TOKEN-- Redis token from Upstash.TINYBIRD_TOKEN-- Admin token for your Tinybird workspace (be sure to create an instance in the GCPus-east4region. This can also be changed via your.envif you prefer a different region). You can also decide to disabled Tinybird and then the analytics and bulk unsubscribe features will be disabled. SetNEXT_PUBLIC_DISABLE_TINYBIRD=trueif you decide to disable Tinybird.
To run the migrations:
pnpm prisma migrate devTo run the app locally:
pnpm run devOr from the project root:
turbo devOpen http://localhost:3000 to view it in your browser. To upgrade yourself to admin visit: http://localhost:3000/admin.
You need to enable these scopes in the 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
Follow the instructions here to setup the pipes and datasources.
Optional: If you want to store AI usage stats in Tinybird too, then do the same in /packages/tinybird-ai-analytics.
Follow instructions here.
Set env var GOOGLE_PUBSUB_TOPIC_NAME.
When creating the subscription select Push and the url should look something like: https://www.getinboxzero.com/api/google/webhook?token=TOKEN or https://abc.ngrok-free.app/api/google/webhook?token=TOKEN where the domain is your domain. Set GOOGLE_PUBSUB_VERIFICATION_TOKEN in your .env file to be the value of TOKEN.
To run in development ngrok can be helpful:
ngrok http 3000
# or with an ngrok domain to keep your endpoint stable (set `XYZ`):
ngrok http --domain=XYZ.ngrok-free.app 3000And then update the webhook endpoint in the Google PubSub subscriptions dashboard.
To start watching emails visit: /api/google/watch/all