Welcome to GeniOS AI Agents, a high-performance suite of intelligent, autonomous agents designed to streamline personal and professional workflows. Built with Gemini 2.5 Flash, LangGraph, and a distributed service architecture, GeniOS provides state-of-the-art reasoning, structured execution, and long-term semantic memory.
The project has evolved into a robust, multi-service architecture to ensure scalability, reliability, and local control. We have successfully migrated from external tool dependencies (Zapier) to a Self-Hosted GeniOS MCP Server.
graph TD
Client[Client/UI] --> Gateway[GeniOS Gateway :8000]
Gateway --> DAA[DAA Service :8001]
Gateway --> Email[EmailAgent :8002]
DAA --> MCPServer[GeniOS MCP Server :9000]
Email --> MCPServer
MCPServer --> GoogleAPI[Google APIs - Gmail/Calendar]
A comprehensive Gmail assistant that goes beyond simple automation.
- Intelligent Classification: Automatically categorizes incoming mail by Sender Type, Intent, and Priority.
- RAG-Powered Drafting: Uses Supabase (pgvector) to remember your writing style and past interactions.
- Safety First: Triple-guardrail protection (PII scanning, Domain validation, Tone enforcement).
Your read-only Executive Assistant for a focused start to the day.
- Self-Hosted Tooling: Now powered by the GeniOS MCP server for direct Google API access.
- Signal Analysis: Aggregates and scores data from Gmail and Google Calendar.
- Risk Detection: Flags calendar conflicts, overloaded schedules, and security alerts.
- Executive Briefing: Generates a concise "Attention List" of high-priority items.
| Component | Technology |
|---|---|
| Frontend | Streamlit (Python UI) |
| LLMs | Gemini 2.5 Flash, Gemini 1.5 Pro |
| Orchestration | LangGraph (Stateful Workflows) |
| Gateway | FastAPI + httpx (Proxying & Routing) |
| MCP Server | Python + Google API Client (OAuth2) |
| Memory | Supabase + pgvector (Semantic Retrieval) |
| APIs | Google Workspace (Gmail, Calendar) |
.
├── frontend/ # Streamlit UI (Port 8501)
├── gateway/ # Unified Entry Point (Port 8000)
├── daily_attention_agent/ # DAA Logic Service (Port 8001)
├── mcp_server/ # Self-Hosted Tool Server (Port 9000)
├── EmailAgent/ # Gmail Drafting Agent (Port 8002)
├── requirements.txt # Root dependencies
└── README.md # This file
- Python 3.10+
- Google Cloud Project with Gmail/Calendar APIs enabled.
- OAuth 2.0 Desktop Credentials (
credentials.json).
# 1. Install root dependencies
pip install -r requirements.txt
# 2. Configure environment
# Ensure .env exists in daily_attention_agent/ and root.
# Place credentials.json in mcp_server/To run the full GeniOS stack, start the services in separate terminals:
# Terminal 1: MCP Server (Tool Access)
bash mcp_server/start.sh
# Terminal 2: DAA Service (Logic)
bash daily_attention_agent/uvicorn_start.sh
# Terminal 3: EmailAgent Service
bash EmailAgent/uvicorn_start.sh
# Terminal 4: Gateway (Unified API)
bash gateway/start.sh
# Terminal 4: Frontend (UI)
bash frontend/start.shbash run_tests.sh- Unified Web Interface: Migration of CLI tools to a premium Next.js dashboard.
- Cross-Agent Coordination: Enabling shared context between DAA and EmailAgent via the Gateway.
- Slack/Jira Integration: Expanding the signal sources in the MCP Server.
- Advanced Evaluation: Implementing an Evals pipeline to measure agent performance.
This project is licensed under the MIT License - see the LICENSE file for details.
GeniOS: Intelligence where it matters most.