"Your Personal AI Infrastructure. Private. Extensible. Yours."
FRIDAY is an open-source, MIT-licensed personal AI assistant framework built in Python. It learns from your data, works with your tools, and talks on your channels — without vendor lock-in.
Inspired by the best ideas from OpenHuman, Hermes Agent, and OpenClaw — but rebuilt from scratch in clean-room fashion.
- 🔧 Engineering Tools: Terminal, file ops, code execution, web browsing, cron jobs
- 🧠 Memory System: Hierarchical summaries, session persistence, vector search
- 🔌 Auto-Sync Connectors: Gmail, Calendar, Slack, Notion, GitHub — auto-fetched every 20 minutes
- 📦 Token Compression: 70-80% token savings before hitting the LLM
- 📡 Multi-Channel Gateway: Telegram (primary), Discord, Web UI, WhatsApp
- 🎯 Skills System: Reusable
SKILL.mdplaybooks - 🤖 Subagents: Spawn parallel AI workers for complex tasks
- 🔒 Local-First: Your data stays on your machine
# Install
pip install friday-ai
# Configure
friday --setup
# Run
friday --chat
# Or with gateway
friday --gateway telegramfriday-core/ Agent reasoning loop, tools, subagents, skills
friday-memory/ Hierarchical memory tree, embeddings, sessions
friday-sync/ Auto-fetch connectors (Gmail, Slack, Notion, etc.)
friday-compress/ TokenJuice-style compression engine
friday-voice/ Optional STT/TTS/wake word (optional)
friday-ui/ Optional FastAPI + React web interface
skills/ User-defined SKILL.md playbooks
| Layer | Technology |
|---|---|
| Backend | Python 3.11+, Asyncio |
| Web Framework | FastAPI |
| Database | SQLite (default), ChromaDB (vectors) |
| Task Queue | APScheduler |
| Connectors | httpx + pydantic + async OAuth2 |
| Gateway | python-telegram-bot, discord.py |
| UI (optional) | React + Vite + Tailwind |
MIT © Hemsagar
Disclaimer: FRIDAY is an independent project. The name is a cultural reference, not an affiliation with Marvel/Disney.
Status: Phase 0 (Foundation) — Active Development