Aegis LifeOS is an AI-powered Google Calendar sidebar add-on that plans and schedules learning goals directly into your calendar. It uses a multi-agent architecture to understand your intent, generate detailed learning roadmaps, detect scheduling conflicts, and book sessions — all from a panel inside Google Calendar.

• Google Calendar Sidebar — interact with Aegis without leaving your calendar
• Multi-Agent Orchestration — specialized agents for planning, scheduling, and coordination
• Smart Scheduling — detects conflicts and books study sessions automatically
• Learning Roadmaps — generates multi-week curricula for any topic
• Human-in-the-Loop — approve, revise, or reject plans before they hit your calendar
• Knowledge Base — upload PDFs so the AI can answer questions from your documents

graph LR
    User([User]) -->|Calendar Sidebar| GAS[Google Apps Script]
    GAS -->|API Request| Orchestrator{Orchestrator Agent}
    
    Orchestrator -->|Intent: Learn| Planner[Planner Agent]
    Orchestrator -->|Intent: Schedule| Scheduler[Scheduler Agent]
    
    Planner -->|RAG| KB[(Knowledge Base)]
    Scheduler -->|Manage| GCal[Google Calendar]
    
    KB -->|Context| Planner
    GCal -->|Availability| Scheduler

• Python 3.10+
• A Google Cloud Console project with the Google Calendar API enabled
• A Google Gemini API key

git clone https://github.com/noahnghg/Aegis.git
cd Aegis

cd backend
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt

Create a .env file in backend/:

GEMINI_API_KEY=your_key_here

1. Go to the Google Cloud Console.
2. Create or select a project.
3. Enable the Google Calendar API.
4. Configure the OAuth Consent Screen (External or Internal).
5. Create OAuth Client ID credentials (Application type: Desktop App).
6. Download the JSON file and save it as credentials.json inside backend/.

cd backend
uvicorn app.main:app --reload

The API will be available at http://localhost:8000.

Note: For the Google Apps Script add-on to reach your local backend, you must expose it via a tunnel like ngrok:

ngrok http 8000

Copy the generated https://...ngrok-free.app URL — you will need it in the next step.

1. Go to script.google.com → New Project.
2. Rename the project to Aegis LifeOS.
3. Replace the contents of Code.gs with the file from google_apps_script/Code.gs.
4. Update the BASE_URL variable at the top of Code.gs with your backend URL (ngrok or production).
5. In the editor sidebar, click the gear icon (Project Settings):
   • Enable Show "appsscript.json" manifest file in editor.
6. Open appsscript.json in the editor and replace its contents with google_apps_script/appsscript.json.
7. Click Deploy → Test deployments → select Google Workspace Add-on → Install.
8. Open Google Calendar. Click the Aegis LifeOS icon in the right sidebar.

Aegis/
├── backend/
│   ├── app/
│   │   ├── agents/        # Orchestrator, Planner, Scheduler agents
│   │   ├── core/          # Ingestion, RAG, config
│   │   ├── tools/         # Google Calendar tool
│   │   └── main.py        # FastAPI entrypoint
│   └── requirements.txt
├── google_apps_script/
│   ├── Code.gs            # Add-on UI and API calls
│   └── appsscript.json    # Manifest with scopes and triggers
└── README.md

MIT