🤖 MYJarvis

Personal AI Operating System — built on Claude Code Max

A self-hosted, multi-channel personal AI that knows you deeply, learns autonomously, and runs 24/7 — all without per-message API costs.

---

✨ What makes MYJarvis different

🧠 Claude Opus 4.7 (1M context)    via Claude Code Max — $0 per message
🤝 Knows you deeply                 600+ word personality profile, auto-extracted
💭 Self-improving                    Reflexion loop nightly — learns from mistakes
🏛️ 8-perspective Council            Multi-angle deliberation in 1 LLM call
📡 Multi-channel                     Telegram + Web + CLI (voice next)
🔌 MCP-native                        Custom + official MCP servers
🛡️ Trust gates                       4-level safety (auto / approve / confirm / block)
🔄 24/7 daemon                       systemd auto-restart + watchdog self-heal
📊 Pattern detection                 Insight Layer finds behaviors you don't notice
🎯 Goal tracking                     Long-term life goals with progress
📚 Persistent memory                 SQLite + auto fact-extraction + dedup

---

🏗️ Architecture (5 Layers)

INTERFACE       Telegram | Web UI | CLI | (Voice future)
                              ↕
HARNESS         Tier 0/1 prompts · Smart routing · Importance gate
                              ↕
BRAIN           ★ claude -p subprocess (Max plan, $0 extra)
                              ↕
MEMORY          SQLite + FTS5 search · Personality profile · Goals · Reflexion lessons
                              ↕
ACTION          MCP servers (filesystem · memory · time · custom)
                              ↕
DEFENSE         Watchdog · Trust gates · Auto-restart · Audit trails

📁 Project Layout

myjarvis/
├── 🧠 brain/               (16 modules — 2,500+ lines)
│   ├── spawn_claude.py     subprocess wrapper for claude -p
│   ├── personality.py      dynamic system prompt + facts
│   ├── importance_gate.py  Haiku-based 1-5 scoring
│   ├── router.py           tier classification
│   ├── agent.py            pipeline orchestrator
│   ├── council.py          8-perspective deliberation
│   ├── reflection.py       Reflexion self-critique
│   ├── insights.py         pattern detection
│   ├── trust.py            4-level safety gates
│   ├── status.py           dashboard
│   ├── routines.py         scheduled tasks
│   ├── scheduler.py        cron-style runner
│   ├── watchdog.py         self-healing health checks
│   ├── rate_limiter.py     Max plan budget tracker
│   ├── goals.py            long-term goals
│   └── onboarding.py       deep introspection
│
├── 💾 memory/
│   ├── store.py            SQLite (conversations, facts, sessions)
│   ├── search.py           FTS5 full-text search
│   └── export_import.py    backup/restore JSON
│
├── 📡 channels/
│   ├── cli_chat.py         terminal interface
│   ├── telegram_bot.py     Telegram (aiogram)
│   └── web_ui.py           FastAPI + admin dashboard
│
├── 🔌 mcp_servers/
│   ├── example/            template for custom MCPs
│   ├── kruai/              business integration (DB-ready)
│   ├── shopdesc/           SaaS integration (DB-ready)
│   └── jarvis_self/        self-introspection
│
├── 📦 deploy/
│   ├── jarvis.service      systemd unit
│   ├── cloudflared.service public tunnel
│   └── README.md           server deployment guide
│
└── main.py                 master orchestrator

---

🚀 Quick Start (Local)

Requirements

• Python 3.11+
• Claude Code Max subscription (already authenticated via claude CLI)
• Telegram bot token (from @BotFather, optional)

Setup

git clone https://github.com/YINDEEINDY/MYJarvis.git
cd MYJarvis

# Install Python deps
pip install -r requirements.txt

# Copy config template
cp config/.env.example config/.env
# Edit config/.env — add TELEGRAM_BOT_TOKEN and TELEGRAM_ALLOWED_USER_ID

# Run
python main.py

Open http://localhost:8000 for chat UI, or http://localhost:8000/admin for dashboard.

CLI Mode (no setup)

python channels/cli_chat.py

Windows shortcuts

chat.bat               — CLI chat
web.bat                — Web UI
start.bat              — Full stack (Telegram + Web + Scheduler)
install_autostart.bat  — Auto-start on Windows login

---

🌐 Server Deployment

For 24/7 production deployment on Linux:

# See deploy/README.md for full guide
ssh user@your-server
sudo cp deploy/jarvis.service /etc/systemd/system/
sudo systemctl enable --now jarvis

Optional: public URL via Cloudflare Tunnel:

# Quick (random URL)
cloudflared tunnel --url http://localhost:8000

# Permanent (with domain)
cloudflared tunnel login
cloudflared tunnel create myjarvis
cloudflared tunnel route dns myjarvis jarvis.yourdomain.com

---

🎮 Commands

Command	Description
/status	Dashboard: messages, facts, cost
/facts	Show all learned facts
/council <q>	8-perspective deliberation
/reflect	Self-critique on recent conversations
/insights	Detect behavioral patterns
/trust <action>	Check action safety level
/search <q>	Full-text search memory
/goals	List active goals
/usage	Rate limit status
/clear	Reset session
/help	List all commands

Available across all channels (CLI, Telegram, Web).

---

🔌 Custom MCP Servers

Plug MYJarvis into anything. Example template at mcp_servers/example/server.py (~100 lines, no SDK required — pure Python JSON-RPC over stdio).

Built-in:

• filesystem — read/write files (sandboxed)
• memory — Anthropic knowledge graph
• sequential-thinking — step-by-step reasoning
• time — date/time queries

User-customizable:

• kruai / shopdesc — business data integration (mock until you plug in DB)
• jarvis_self — MYJarvis introspects own state

---

🧪 What's Inside the Brain

Personality Profile (auto-built):

• Identity, family, work projects
• Values, decision style, energy patterns
• Boundaries (what NOT to do)
• Goals (short/medium/long term)
• Communication preferences

Reflexion Loop (nightly):

• "What went well today?"
• "What did I miss?"
• Extracts new facts → saves to memory
• Updates personality based on user corrections

8-Perspective Council:

🏛️ CEO (strategic)         💼 Business (ROI)
🔧 Engineer (practical)     🛡️ Risk (paranoid)
🎨 Creator (bold)           ❤️ Empath (emotional)
⚖️ Critic (devil's advocate) 📊 Analyst (data)

All 8 in one LLM call → synthesized recommendation.

Insight Layer: Detects patterns the user doesn't notice — communication style, mood signals, recurring topics, blind spots.

---

💰 Cost Model

Subscription:   $0 extra (uses Claude Code Max — paid as you do)
Server:         Self-hosted (any Debian/Ubuntu box)
Marginal:       $0 per message (no API charges)
Optional:       Cloudflare ($0), domain ($10/yr for permanent URL)

Smart routing keeps Max plan rate limits sustainable:

• Trivial messages → Haiku (cheap)
• Normal → default
• Complex → Opus extended thinking
• Importance gate filters what's worth saving

---

🛡️ Safety

🟢 FULL_AUTO          Routine actions (read email, check status)
🟡 ASK_APPROVE        Medium stakes (send email, schedule meeting)
🟠 ALWAYS_CONFIRM     High stakes (deploy prod, transfer money)
🔴 BLOCKED            Hard rules (rm -rf, drop database, leak secrets)

Plus: Trust Levels Drift Detection (weekly review of self-modifications)

---

📊 Phase Progress

Phase 0  ████████████████████  Foundation
Phase 1  ████████████████████  Personality + Memory
Phase 2  ████████████████████  Council + Reflection + Insights
Phase 3  ████████████████████  Routines + MCPs + Self-heal
Phase 4  ████████████████████  Rate limit + Search + Goals + Telegram
Phase 5  ████████████████████  Server 24/7 (systemd)
Phase 6  ████████████████████  Public URL (Cloudflare Tunnel)
Phase 7  ████████████████████  Custom MCPs + Deep Profile

Future:  Voice (wake word + STT + Thai TTS)
         Smart Home (Home Assistant)
         Permanent URL via owned domain

---

🙏 Inspired by

• microsoft/JARVIS (HuggingGPT)
• Ramsbaby/jarvis (Discord-based personal AI)
• Sid Bharath's Jarvis (Claude Code as life OS)
• Reflexion (verbal self-critique)
• Model Context Protocol

---

📜 License

MIT — See LICENSE

---

"My Jarvis — a personal AI that doesn't replace me, but extends me. It remembers what I forget, sees patterns I miss, and works while I rest."