A Privacy-First Daily Brief System for Gmail, Slack & GitHub

ZeroTask is a local-first desktop/web application that aggregates your Gmail, Slack, and GitHub notifications into a single, action-ready daily brief. Built with privacy and security in mind, it runs entirely on your machine with shared service account architecture for company deployment.

• Node.js 18+ and npm
• Python 3.8+ and pip
• Git for version control

1. Clone the repository:

   git clone https://github.com/SankaiAI/ZeroTask.git
   cd ZeroTask

2. Start the backend:

   cd zerotask-backend
   python -m venv venv
   # On Windows:
   venv\Scripts\activate
   # On macOS/Linux:
   source venv/bin/activate
   pip install -r requirements.txt
   python -m app.main

3. Start the frontend:

   cd zerotask-frontend
   npm install
   npm run dev

4. Access the application:

   • Frontend: http://localhost:3001 (or 3000 if available)
   • Backend API: http://localhost:8000
   • API Documentation: http://localhost:8000/docs

• 📧 Gmail Integration - Read emails and create draft replies (OAuth 2.0)
• 💬 Slack Integration - Individual user OAuth with profile display and API access
• 🔧 GitHub Integration - Monitor assigned issues and PR reviews (Service Account)
• 🤖 AI-Powered Summarization - Using local Ollama or BYOK LLM providers
• 🔗 Smart Deduplication - Merge related items across platforms
• ⚡ Action-Ready Cards - Open, reply, snooze, and follow-up actions

• 🏠 Local-First Architecture - All data stored locally
• 🔐 Encrypted Token Storage - OAuth tokens and service credentials secured with AES-256
• 👤 Individual User Authentication - Personal OAuth flows for Gmail and Slack
• 🏢 Company Deployment Ready - IT-managed service accounts for GitHub
• 🔒 No Central Server - Zero data sent to external services

• 👨‍💼 User Profile Display - Show Slack user avatars, names, emails, and titles
• 🎯 Improved UX - Removed intrusive alert popups, console logging for debugging
• 🔗 OAuth Callback Handling - Seamless popup-based OAuth flows with automatic status updates
• 🛡️ Enhanced Security - Proper token encryption and secure credential management

• Frontend: Next.js 14, TypeScript, Tailwind CSS
• Backend: FastAPI, SQLite, SQLAlchemy
• LLM: Ollama (local) or LiteLLM (BYOK)
• Authentication: Environment-based shared service accounts

┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Next.js │ │ FastAPI │ │ SQLite │
│ Frontend │◄──►│ Backend │◄──►│ Database │
│ (Port 3000) │ │ (Port 8000) │ │ (Local File) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
 │ │
 │ ▼
 │ ┌─────────────────┐
 │ │ External │
 └──────────────┤ Services │
 │ • Gmail API │
 │ • Slack API │
 │ • GitHub API │
 └─────────────────┘

For company internal deployment, IT teams configure shared service accounts:

# Create service account: zerotask-bot@company.com
# Generate PAT with scopes: repo, read:user, notifications
export GITHUB_TOKEN=ghp_your_service_account_token

# Create Slack OAuth app for individual user authentication
# Configure OAuth scopes: channels:read, chat:write, users:read, users:read.email, channels:history, groups:read, im:read
export SLACK_CLIENT_ID=your_oauth_client_id
export SLACK_CLIENT_SECRET=your_oauth_client_secret
# Configure OAuth redirect URI: https://your-domain.com/oauth2/slack/callback

# Configure Google Cloud OAuth 2.0 credentials
export GOOGLE_CLIENT_ID=your_oauth_client_id
export GOOGLE_CLIENT_SECRET=your_oauth_client_secret
# Configure OAuth redirect URI: http://localhost:8000/oauth2/callback

📋 See IT_SETUP.md for detailed configuration instructions.

Copy and configure the environment file:

# Backend configuration
cd zerotask-backend
cp .env.example .env
# Edit .env with your service account credentials

• LLM Provider: Choose between Ollama (local) or BYOK providers
• Polling Intervals: Configure how often to check each service
• Daily Brief Time: Set when to generate daily summaries
• Security Settings: Configure encryption and authentication

• PRD.md - Complete Product Requirements Document
• IT_SETUP.md - IT team setup guide for service accounts
• CHANGELOG.md - Version history and changes
• CLAUDE.md - Development governance and contribution rules

• GET /api/v1/auth/validate - Check all service configurations
• GET /api/v1/auth/status/{provider} - Get provider connection status
• GET /api/v1/auth/github/test - Test GitHub connection
• GET /api/v1/auth/slack/oauth/status - Get Slack OAuth status and user profile
• GET /api/v1/auth/slack/oauth/start - Start Slack OAuth flow
• GET /api/v1/auth/gmail/status - Check Gmail OAuth configuration
• GET /api/v1/auth/gmail/oauth/start - Start Gmail OAuth flow

• GET /api/v1/health - API health check
• GET / - Root endpoint with API information

ZeroTask/
├── zerotask-frontend/ # Next.js frontend
│ ├── src/components/ # React components
│ ├── src/app/ # App router pages
│ ├── src/lib/ # Utilities and helpers
│ └── public/ # Static files and OAuth callbacks
├── zerotask-backend/ # FastAPI backend
│ ├── app/api/ # API endpoints
│ ├── app/models/ # SQLAlchemy models
│ ├── app/services/ # Business logic (including OAuth services)
│ └── app/utils/ # Utilities and encryption
└── docs/ # Documentation

# Frontend development
cd zerotask-frontend
npm run dev # Start development server
npm run build # Build for production
npm run lint # Run ESLint
# Backend development
cd zerotask-backend
python -m app.main # Start development server
pip install -r requirements.txt # Install dependencies

# Frontend testing
cd zerotask-frontend
npm test
# Backend testing
cd zerotask-backend
pytest

1. Configure environment variables for production
2. Build frontend application:

   cd zerotask-frontend
   npm run build

3. Start backend server:

   cd zerotask-backend
   python -m app.main

# Build and run with Docker Compose
docker-compose up --build

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Follow the governance rules in CLAUDE.md
4. Ensure PRD compliance for any scope changes
5. Commit your changes: git commit -m 'Add amazing feature'
6. Push to the branch: git push origin feature/amazing-feature
7. Open a Pull Request

• Follow the PRD - All changes must comply with the Product Requirements Document
• Update CHANGELOG.md - Document all changes following Keep a Changelog format
• Test thoroughly - Ensure all features work across platforms
• Security first - Never commit secrets or compromise privacy-first architecture

• Slack + GitHub integration
• Shared service account architecture
• Basic daily brief generation
• IT setup documentation

• Gmail OAuth integration
• Slack individual user OAuth with profile display
• Enhanced frontend with user profile avatars
• Improved error handling and user experience

• LLM summarization with Ollama
• Priority scoring algorithm
• Follow-up task management
• Advanced deduplication

• Export to Markdown
• Background job scheduling
• Enhanced preferences UI
• Mobile responsiveness

• Local-first architecture - No data leaves your machine
• Encrypted credentials - All tokens encrypted at rest
• Minimal API scopes - Only necessary permissions requested
• No telemetry - Optional opt-in only
• Audit logging - All actions logged locally

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: Check the docs/ directory
• IT Support: Contact your organization's IT team for service account setup

This project is licensed under the MIT License - see the LICENSE file for details.

• Claude Code - AI-powered development assistant
• FastAPI - Modern Python web framework
• Next.js - React framework for production
• Ollama - Local LLM deployment
• Tailwind CSS - Utility-first CSS framework

Built with privacy in mind. Your data stays on your machine.

Generated with Claude Code - AI-powered development assistant