diff --git a/docs/devto-article.md b/docs/devto-article.md new file mode 100644 index 0000000..2322c1b --- /dev/null +++ b/docs/devto-article.md @@ -0,0 +1,124 @@ +--- +title: I Built an Open-Source Agent OS — Here's the Architecture +published: false +description: "How I built Agentic OS: a locally-hosted multi-agent orchestration platform that coordinates opencode, Hermes Agent, and Gemini CLI into one dashboard with 16+ skills, cron scheduler, cost analytics, and persistent memory. Full architecture breakdown." +tags: [agents, devops, opensource, python, fastapi] +cover_image: https://raw.githubusercontent.com/modimihir07/agentic-os/main/docs/og-image.png +--- + +# I Built an Open-Source Agent OS — Here's the Architecture + +Most AI agent tools work in isolation. You have a terminal for coding, a separate chat for research, another dashboard for monitoring, and yet another tool for memory. Each one is powerful alone, but together? Chaos. + +That's why I built **Agentic OS** — a locally-hosted operating system for AI agents that coordinates three agents (opencode, Hermes Agent, and Gemini CLI) into one unified dashboard. + +![Agentic OS Architecture](https://raw.githubusercontent.com/modimihir07/agentic-os/main/docs/og-image.png) + +**GitHub**: [github.com/modimihir07/agentic-os](https://github.com/modimihir07/agentic-os) + +## The Problem + +I was using: +- **opencode** for code generation and DevOps tasks +- **Hermes Agent** for persistent memory and scheduling +- **Gemini CLI** for web research and analysis + +Each was great at its job, but there was no central hub. No shared memory. No unified dashboard. No way to chain them together. Every session started from zero. + +## The Solution: 7-Layer Architecture + +Instead of a flat "three agents" approach, I designed a **7-layer architecture** that standardizes how agents interact: + +``` +Layer 7: Identity / Persona / Constitution +Layer 6: Self-Evolution + Capability Manager +Layer 5: Scheduler + Awareness + Health Guardian +Layer 4: Memory Graph + Memory Consolidation +Layer 3: Skills Hub + Eval + Learnings Loop +Layer 2: Business Brain + Context Folders +Layer 1: Agent Router + Standards + Profiles +``` + +### Layer 1: Agent Router +Routes tasks to the right agent automatically: +- **Code/DevOps task?** → opencode +- **Memory/Scheduling?** → Hermes +- **Research/Analysis?** → Gemini CLI +- **Complex multi-step?** → Chain: Gemini researches → opencode implements → Hermes monitors + +### Layer 3: Skills Hub (16 Skills) +Each skill has a standardized structure: +``` +skills/skill-name/ +├── SKILL.md # Instructions +├── learnings.md # Accumulated knowledge +├── eval.json # Scoring criteria +├── score-history.json # Performance tracking +└── context/ # Task inputs +``` + +This means skills improve over time — the more you run them, the smarter they get. + +### Layer 4: Persistent Memory +All agents read from a shared `brain/` folder at session start. Hermes provides SQLite FTS5 for full-text search across all past conversations. + +## Feature Highlights + +| Feature | What it does | +|---------|-------------| +| 3-Agent Engine | opencode + Hermes + Gemini CLI with auto-routing | +| 16 Skills | Executable packs with eval scoring | +| Cron Scheduler | APScheduler jobs (heartbeat, standup, audit) | +| Cost Analytics | Track spending across providers | +| One-Click Backup | Full tar.gz snapshots | +| Audit Trail | Every action logged | +| Prompt Library | 10 reusable templates | +| Dark/Light Theme | GitHub-style dark mode | + +## Comparison with Julian Goldie's Claude Agent OS + +I was inspired by Julian Goldie's "Agent OS: Claude + Hermes = Superpowers" video. Here's an honest comparison: + +| Feature | Claude Agent OS | Agentic OS (Mine) | +|---------|----------------|-------------------| +| Core Agents | Claude + OpenClaw + Hermes | opencode + Hermes + Gemini | +| Cost | $20/mo (Claude) | **$0 (all free tiers)** | +| Stack | Next.js + Tailwind | FastAPI + vanilla JS | +| Memory | Obsidian (external) | **Built-in brain/ + SQLite** | +| Cost Tracking | None | **Built-in analytics** | +| Backup/Restore | None | **One-click** | +| Open Source | No | **MIT License** | + +## Tech Stack + +- **Backend**: FastAPI (Python) +- **Frontend**: Vanilla JS SPA (no framework) +- **Scheduler**: APScheduler +- **Memory**: SQLite FTS5 + Markdown files +- **Agents**: opencode, Hermes Agent, Gemini CLI +- **Cost**: $0 — all free tiers (Gemini Flash, OpenRouter free models) + +## Quick Start + +```bash +git clone https://github.com/modimihir07/agentic-os.git +cd agentic-os +chmod +x install.sh && ./install.sh +./start.sh +# Open http://127.0.0.1:8080 +``` + +## What's Next + +I'm planning to add: +- More skills (Kubernetes monitoring, CI/CD pipelines) +- Agent handoff protocol for complex multi-step tasks +- Web search integration across all agents + +--- + +**Agentic OS** is open-source under MIT. Star it on GitHub if you find it useful! + +👉 **[github.com/modimihir07/agentic-os](https://github.com/modimihir07/agentic-os)** + +Questions? Comments? Open an issue or join the discussions on GitHub. diff --git a/docs/index.html b/docs/index.html new file mode 100644 index 0000000..f2da683 --- /dev/null +++ b/docs/index.html @@ -0,0 +1,257 @@ + + + + + + + +Agentic OS — Multi-Agent Orchestration Platform | opencode + Hermes + Gemini CLI + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ +

Agentic OS

+

A locally-hosted operating system for AI agents — orchestrating opencode, Hermes Agent, and Gemini CLI into one unified dashboard with persistent memory, cron scheduling, 16+ skills, and cost analytics.

+
+ MIT + Python + 3 Agents + 16 Skills + Stable +
+
+ GitHub Repo + Documentation + ⭐ Star on GitHub +
+
+
+ +
+
+

Why Agentic OS?

+

Most AI agent tools work in isolation — a terminal for coding, a chat for research, another tool for memory. Agentic OS is the control plane that unifies them: three agents, one dashboard, one memory layer, one scheduler, one skill hub.

+
+
🤖

3-Agent Engine

opencode (code/DevOps), Hermes (memory/scheduling), Gemini (research) with automatic task routing.

+
🧩

16+ Skills

Executable packs with eval scoring, learnings, and score history. Run from one click.

+
🧠

Persistent Memory

Shared brain/ folder + Hermes SQLite FTS5 — all agents share context across sessions.

+
⏱

Cron Scheduler

APScheduler jobs: heartbeat, standup, DevOps audit, memory consolidation. Fully configurable.

+
💰

Cost Analytics

Track spending across providers with free-tier alerts. No surprise bills.

+
💾

One-Click Backup

Full tar.gz snapshot of configs, skills, brain, agents, prompts. Full restore in one command.

+
📋

Audit Trail

Every action logged — chat, skill runs, config changes, backups. Searchable event history.

+
📝

Prompt Library

10 reusable templates: code review, system audit, project plan, brainstorm, and more.

+
🎨

Dark/Light Theme

GitHub-style dark mode with clean light theme. Collapsible sidebar with agent status.

+
⚡

Zero API Costs

Built for free tiers — Gemini Flash, OpenRouter free models, local opencode. No subscription needed.

+
📐

Standards System

Discover and inject project conventions automatically.

+
🔌

Plugin Registry

Marketplace-style plugin management. Extend via custom skills.

+
+
+
+ +
+
+

Agent Architecture

+

Three specialized agents, one orchestration layer.

+
+ ┌──────────────────────────────────────────────┐ + │ AGENTIC OS DASHBOARD │ + │ FastAPI + Tailwind SPA │ + ├──────────────────────────────────────────────┤ + │ │ + │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ + │ │ opencode │ │ Hermes │ │ Gemini │ │ + │ │Code/DevOp│ │Mem/Sched │ │Research │ │ + │ └──────────┘ └──────────┘ └──────────┘ │ + │ │ + │ ┌──────────────────────────────────────┐ │ + │ │ 7 CORE LAYERS (Stacked) │ │ + │ │ Layer 7: Identity/Persona │ │ + │ │ Layer 6: Self-Evolution │ │ + │ │ Layer 5: Scheduler + Health │ │ + │ │ Layer 4: Memory Graph │ │ + │ │ Layer 3: Skills Hub + Eval │ │ + │ │ Layer 2: Business Brain │ │ + │ │ Layer 1: Agent Router │ │ + │ └──────────────────────────────────────┘ │ + └──────────────────────────────────────────────┘ +
+
+
+ +
+
+

Comparison: Agentic OS vs Julian Goldie's Claude Agent OS

+

An honest comparison of the two projects.

+ + + + + + + + + + + + + + + + +
FeatureClaude Agent OS (Video)Agentic OS (This Project)
Core AgentsClaude + OpenClaw + Hermesopencode + Hermes + Gemini CLI
Cost$20/mo (Claude sub)$0 — all free tiers
StackNext.js + TailwindFastAPI + vanilla JS SPA
Architecture Layers4 layers7 layers
Skills SystemPlugin marketplace16 curated + eval scoring + learnings
MemoryObsidian vault (external)Built-in brain/ + SQLite FTS5
Cron SchedulerNot shownAPScheduler jobs
Cost TrackingNot shownPer-provider analytics
Backup/RestoreNot shownOne-click snapshots
Audit TrailNot shownFull activity log
Standards SystemNot shownDiscover/inject conventions
Client TimeoutNot shown200s AbortController
Kanban BoardYesNo (not needed)
Open SourceNo (tutorial only)MIT License
+
+
+ +
+
+

Quick Start

+

Get running in 30 seconds.

+
+git clone https://github.com/modimihir07/agentic-os.git +cd agentic-os +chmod +x install.sh && ./install.sh +./start.sh +# Open http://127.0.0.1:8080 +
+
+
+ +
+
+

Ready to build your Agent OS?

+

Agentic OS is free, open-source, and built for developers who want real control over their AI agents.

+
+ ⭐ Star on GitHub + Report Issue + Join Discussion +
+
+
+ + + + + diff --git a/docs/sitemap.xml b/docs/sitemap.xml new file mode 100644 index 0000000..52b6728 --- /dev/null +++ b/docs/sitemap.xml @@ -0,0 +1,21 @@ + + + + https://modimihir07.github.io/agentic-os/ + 2026-05-17 + weekly + 1.0 + + + https://github.com/modimihir07/agentic-os + 2026-05-17 + daily + 0.9 + + + https://github.com/modimihir07/agentic-os/blob/main/README.md + 2026-05-17 + weekly + 0.8 + + diff --git a/docs/social-posts.md b/docs/social-posts.md new file mode 100644 index 0000000..6d19ca5 --- /dev/null +++ b/docs/social-posts.md @@ -0,0 +1,74 @@ +# Social Media Post Drafts + +--- + +## Reddit — r/selfhosted + +**Title**: I built a self-hosted Agent OS that orchestrates opencode, Hermes, and Gemini CLI + +**Body**: +I've been using opencode for code, Hermes for memory/scheduling, and Gemini CLI for research — but jumping between terminals got chaotic. So I built a self-hosted dashboard that orchestrates all three. + +**Agentic OS** features: +- 3-agent engine with automatic routing (code → opencode, memory → Hermes, research → Gemini) +- 16+ skills with eval scoring and performance tracking +- Cron scheduler (APScheduler) — heartbeat, standup, DevOps audit +- Persistent memory across all agents (SQLite FTS5 + shared brain/ folder) +- Cost analytics with free-tier alerts +- One-click backup/restore (tar.gz snapshots) +- Full audit trail +- Prompt template library (10 templates) +- Dark/light theme + +All agents run on free tiers — Gemini Flash, OpenRouter free models, local opencode. No subscription needed. + +**GitHub**: https://github.com/modimihir07/agentic-os +**Tech**: FastAPI + vanilla JS SPA, MIT license + +Happy to answer questions or take suggestions! + +--- + +## Reddit — r/devops + +**Title**: Agentic OS — open-source multi-agent orchestration for DevOps workflows + +**Body**: +Spent the last few weeks building an Agent OS that connects opencode (code/DevOps), Hermes (memory/scheduling), and Gemini CLI (research/analysis) into a single dashboard. + +Why it matters for DevOps: +- Route tasks to the right agent automatically +- Scheduled cron jobs for infrastructure audits +- Cost tracking across providers (prevent surprise bills) +- 16 skills including DevOps audit, code review, TDD cycle +- Shared memory so agents don't forget context +- Backup/restore for disaster recovery + +**GitHub**: https://github.com/modimihir07/agentic-os + +Built with FastAPI + vanilla JS. MIT licensed. All free tiers. + +--- + +## Hacker News + +**Title**: Agentic OS – Self-hosted multi-agent orchestration platform (FastAPI, MIT) + +**Body**: +I built a locally-hosted OS for AI agents that coordinates opencode (code/DevOps), Hermes Agent (memory/scheduling), and Gemini CLI (research/analysis) into one dashboard. + +Key features: +- 3-agent engine with automatic routing +- 16+ skills with eval scoring +- APScheduler cron jobs +- Cost analytics with free-tier alerts +- One-click backup/restore +- Full audit trail +- 7-layer architecture (router → business brain → skills hub → memory → scheduler → self-evolution → identity) +- Dark/light theme + +Stack: FastAPI + vanilla JS SPA. Zero API costs — runs on free tiers (Gemini Flash, OpenRouter free models, local opencode). + +https://github.com/modimihir07/agentic-os + +MIT licensed. Feedback welcome!