Personal AI OS

Your AI Brain - A context-aware personal assistant that manages notes, tasks, and provides proactive daily briefings.

🧠 Features

• Conversational AI: Natural language chat with context awareness
• Notes: Capture and semantically search notes
• Tasks: Smart task management with priorities
• Daily Briefing: AI-generated morning summaries
• Memory: Persistent context across sessions

🚀 Quick Start

Backend

cd backend

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Set up environment
cp .env.example .env
# Edit .env and add your OpenAI API key

# Run the server
uvicorn app.main:app --reload

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

Frontend

cd frontend
npm install
npm run dev

Frontend will be available at http://localhost:3000

📡 API Endpoints

Endpoint	Description
POST /chat	Send a message to the AI
GET /chat/history	Get conversation history
POST /notes	Create a note
GET /notes	List all notes
GET /notes/search?query=...	Semantic search
POST /tasks	Create a task
GET /tasks	List all tasks
GET /tasks/today	Get today's tasks
PATCH /tasks/{id}/complete	Complete a task
GET /briefing	Get daily briefing

🏗️ Architecture

├── backend/
│   ├── app/
│   │   ├── main.py          # FastAPI app
│   │   ├── config.py        # Settings
│   │   ├── models/          # Pydantic schemas
│   │   ├── routers/         # API endpoints
│   │   ├── services/        # AI & memory
│   │   └── db/              # SQLite + Vector DB
│   └── requirements.txt
└── frontend/
    └── (Next.js app)

🔐 Environment Variables

Variable	Description
OPENAI_API_KEY	Your OpenAI API key
DEBUG	Enable debug mode

License

MIT