inbox-zero README

The project's README from github.com/elie222/inbox-zero. As one markdown file: README.md.

Inbox Zero - your 24/7 AI email assistant

Organizes your inbox, pre-drafts replies, manages your calendar, and organizes attachments. Chat with it from Slack or Telegram to manage your inbox on the go. Open source alternative to Fyxer, but more customizable and secure.
Website · Discord · Issues

Stars Forks

elie222%2Finbox-zero | Trendshift

Sponsor

Vercel OSS Program

Mission

To help you spend less time in your inbox, so you can focus on what matters most.

Features

Learn more in our docs.

Feature Screenshots

AI Assistant Reply Zero
AI Assistant Reply Zero
Gmail Client Bulk Unsubscriber
Gmail client Bulk Unsubscriber

Demo Video

Inbox Zero demo

Built with

Star History

Star History Chart

Feature Requests

To request a feature open a GitHub issue, or join our Discord.

Getting Started

We offer a hosted version of Inbox Zero at getinboxzero.com.

Self-Hosting

The fastest way to self-host Inbox Zero is with the CLI:

Prerequisites: Docker and Node.js v24+

npx @inbox-zero/cli setup      # One-time setup wizard
npx @inbox-zero/cli start      # Start containers

Open http://localhost:3000

For complete self-hosting instructions, production deployment, OAuth setup, and configuration options, see our Self-Hosting Docs.

Local Development

Prerequisites: Docker, Node.js v24+, and pnpm v10+

git clone https://github.com/elie222/inbox-zero.git
cd inbox-zero
docker compose -f docker-compose.dev.yml up -d   # Postgres + Redis
pnpm install
npm run setup                                     # Interactive env setup
cd apps/web && pnpm prisma migrate dev && cd ../..
pnpm dev

Open http://localhost:3000

After pnpm install, if you want to use the local Google emulator, start it with:

docker compose -f docker-compose.dev.yml --profile google-emulator up -d

Then point apps/web/.env at it with:

GOOGLE_BASE_URL=http://localhost:4002
GOOGLE_CLIENT_ID=emulate-google-client.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=emulate-google-secret

If you want to use the local Microsoft emulator, start it with:

docker compose -f docker-compose.dev.yml --profile microsoft-emulator up -d

Then point apps/web/.env at it with:

MICROSOFT_BASE_URL=http://localhost:4003
MICROSOFT_CLIENT_ID=emulate-microsoft-client-id
MICROSOFT_CLIENT_SECRET=emulate-microsoft-secret

See the Contributing Guide for more details including devcontainer setup.

Contributing

View open tasks in GitHub Issues and join our Discord to discuss what's being worked on.

Docker images are automatically built on every push to main and tagged with the commit SHA (e.g., elie222/inbox-zero:abc1234). The latest tag always points to the most recent main build. Formal releases use version tags (e.g., v2.26.0).

inbox-zero (elie222/inbox-zero)

shadcn-ui
Searching Database…

What is this?Inbox Zero is an open-source AI personal assistant for email that organizes your inbox, pre-drafts replies in your tone, manages your calendar, and organizes attachments.
Is this a web app I run myself, or a hosted service?It is a self-hostable web app (built with Next.js) that you can run on your own infrastructure, but the team also offers a hosted version so you don't have to host it yourself.
How do I get it running?The fastest route is the official self-hosting CLI, which sets up the stack with Docker and Node.js v24+; alternatively you can skip hosting entirely and sign up at getinboxzero.com.
What do I need installed before self-hosting it?Docker and Node.js v24+ for self-hosting; local development additionally needs pnpm v10+.
Is self-hosting a one-command setup?The CLI gets a basic instance running quickly, but production deployment, OAuth setup, and other configuration need to be done separately following the Self-Hosting Docs.
Is my email data safer with this than with similar tools?It's pitched as an open-source alternative to Fyxer that's more customizable and more secure, largely because you can self-host it instead of handing your inbox to a closed SaaS.
What does Reply Zero do?It tracks which emails you still need to reply to and which ones are awaiting a response from the other person, so nothing falls through the cracks.
Can I manage my inbox without opening the app?Yes, you can chat with the AI assistant from Slack or Telegram to manage your inbox on the go without switching apps.
What happens to cold emails and unwanted newsletters?The Cold Email Blocker auto-blocks cold outreach, and the Bulk Unsubscriber lets you one-click unsubscribe and archive emails you never read.
Does it do anything with my calendar?It generates Meeting Briefs, personalized briefings before every meeting that pull context from both your email and your calendar.
Creator
elie222
Size
117.5 MB
Stars
12.6K
Age
3y
Commits · 90 Days