cclohmar/inboxer
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
inBOXER - Email classification and organization tool using IMAP and AI
7 commits 1 branch 3 tags 32 MiB
Go 78.2%
HTML 9.3%
Shell 6.8%
CSS 4.5%
Makefile 1.2%
Find a file
cclohmar 54dd30a2d6 Add .env.example as single source of truth for secrets documentation 
Anyone cloning the repo can now see exactly which environment variables
are required by reading .env.example at the repo root.

install.sh updated to copy .env.example during deployment (rather than
duplicating the template inline), keeping the two in sync.
2026-04-23 19:57:44 +00:00
bin Distribute binary in repo + add install.sh for /opt/inboxer deployment 2026-04-23 19:53:19 +00:00
docs Phase 4: Polish, settings fix, 7-way AI classification & empty-inbox guarantee (Version: 2026-04.5) 2026-04-23 18:35:30 +00:00
src Phase 4: Polish, settings fix, 7-way AI classification & empty-inbox guarantee (Version: 2026-04.5) 2026-04-23 18:35:30 +00:00
.env.example Add .env.example as single source of truth for secrets documentation 2026-04-23 19:57:44 +00:00
.gitignore Distribute binary in repo + add install.sh for /opt/inboxer deployment 2026-04-23 19:53:19 +00:00
AGENTS.md Phase 4: Polish, settings fix, 7-way AI classification & empty-inbox guarantee (Version: 2026-04.5) 2026-04-23 18:35:30 +00:00
go.mod Phase 2: IMAP Client & Background Worker (Version: 2026-04.2) 2026-04-23 11:02:02 +00:00
go.sum Phase 2: IMAP Client & Background Worker (Version: 2026-04.2) 2026-04-23 11:02:02 +00:00
install.sh Add .env.example as single source of truth for secrets documentation 2026-04-23 19:57:44 +00:00
Makefile Phase 1: Foundation, OTP Auth & Mobile Frontend (Version: 2026-04.1) 2026-04-23 08:26:32 +00:00
PROJECT_PLAN.md Phase 1: Foundation, OTP Auth & Mobile Frontend (Version: 2026-04.1) 2026-04-23 08:26:32 +00:00
README.md Phase 1: Foundation, OTP Auth & Mobile Frontend (Version: 2026-04.1) 2026-04-23 08:26:32 +00:00

README.md

inBOXER

Email classification and organization tool using IMAP and AI.

Overview

inBOXER is a Go application that:

  • Connects to your IMAP email account
  • Uses DeepSeek AI to classify incoming emails
  • Automatically moves emails to appropriate folders (Important, eCommerce, Other, Spam)
  • Provides a web interface for configuration and monitoring

Features

  • Email + OTP Authentication: Secure login without passwords
  • AI-Powered Classification: Uses DeepSeek LLM for intelligent email sorting
  • Mobile-First Web Interface: Responsive design for all devices
  • Modular Architecture: Clean separation of concerns (auth, IMAP, AI, database, worker)
  • Test Mode: Preview AI decisions without moving emails

Quick Start

  1. Clone the repository
  2. Configure .env with your API keys and credentials
  3. Run make build to compile the binary
  4. Run make run to start the application
  5. Access the web interface at http://localhost:8080

Architecture

See PROJECT_PLAN.md for detailed architecture and development phases.

License

See docs/LICENSE.md for license information.