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)

Searching Database…

这是什么?Inbox Zero 是一款开源的 AI 邮件个人助手,可以整理收件箱、按你的语气预先起草回复、管理日历,并整理附件。
这是我自己运行的网页应用,还是托管服务?它是一个可以自行部署的网页应用(使用 Next.js 构建),你可以在自己的基础设施上运行;团队也提供托管版本,你无需自己部署。
怎样才能让它运行起来?最快的方式是使用官方自托管 CLI,它会通过 Docker 和 Node.js v24+ 搭建所需环境;你也可以完全不自托管,直接在 getinboxzero.com 注册。
自托管之前需要先安装什么?自托管需要 Docker 和 Node.js v24+;如果要进行本地开发,还需要 pnpm v10+。
自托管能否一条命令完成?CLI 可以快速运行一个基础实例,但正式部署、OAuth 设置和其他配置需要单独完成,具体请参阅自托管文档(Self-Hosting Docs)。
和同类工具相比,用它处理我的邮件数据更安全吗?它被定位为 Fyxer 的开源替代品,更易于定制、也更安全,主要因为你可以自行部署,而不必把收件箱交给封闭的 SaaS 服务。
Reply Zero 是做什么的?它会追踪哪些邮件你仍需回复,哪些正在等待对方回复,确保不会有任何邮件被遗漏。
我能不打开应用就管理收件箱吗?可以,你可以通过 Slack 或 Telegram 与 AI 助手聊天,随时管理收件箱,无需切换应用。
冷邮件和不需要的订阅邮件会怎样处理?Cold Email Blocker 会自动拦截冷邮件推广,Bulk Unsubscriber 则可以一键退订并归档你从未阅读的邮件。
它会处理我的日历吗?它会生成会议简报(Meeting Briefs),即每次会议前的个性化简报,同时结合你的邮件和日历内容提供背景信息。
Creator
elie222
Size
117.4 MB
Stars
12.6K
Age
3y
Commits · 90 Days