- 
-
- Self-improving AI agent on C# / .NET 10
- Creates skills from experience · improves them during use · remembers context between sessions
-
- 
- 
-
Самообучающийся ИИ-агент на C# / .NET 10
- Создаёт навыки из опыта · улучшает их в процессе использования · помнит контекст между сессиями
+ Создаёт навыки из опыта · улучшает их в процессе использования · помнит контекст между сессиями · объединяет агенты в mesh-сеть
+ 
Self-improving AI agent on C# / .NET 10
- Creates skills from experience · improves them during use · remembers context between sessions
+ Creates skills from experience · improves them during use · remembers context between sessions · connects agents into a mesh
+ 
+
+ 
English · Русский + · Quick start + · Docs + · Try Telegram bot
--- -**Hercules** is a compact self-improving micro-agent that reproduces the key *self-improving* characteristics -of "hermes-style" agents (Nous Research) in a runnable form factor. +**One-liner:** Hercules is a runnable, self-improving C# micro-agent that learns from conversations, +versions its own skills, runs code in a sandbox, and can team up with other agents over a mesh. + +
+
+ 
+
+
+ 🎬 Watch 60-sec demo + · 📁 Examples + · 🤝 Good first issues +
+ +--- + +## 🏗️ Architecture at a glance + +``` +┌─────────────────────────────────────────────────────────────────────┐ +│ Interfaces: CLI REPL · Telegram bot · Web API · Studio SPA (Vue 3) │ +├─────────────────────────────────────────────────────────────────────┤ +│ Agent Core → Skill Router → Reflection → Memory Manager │ +│ ↓ ↓ ↓ ↓ │ +│ Multi-role LLM routing (YandexGPT / Ollama / LM Studio) │ +├─────────────────────────────────────────────────────────────────────┤ +│ Tools: HTTP · execute_code · A2A · MCP · WASM │ +├─────────────────────────────────────────────────────────────────────┤ +│ Mesh: capability registry · intent routing · circuit breaker │ +├─────────────────────────────────────────────────────────────────────┤ +│ Storage: Markdown skills/memory + SQLite logs + Redis/NATS/PG │ +└─────────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 🚀 Quick start + +```bash +# Clone + git clone https://github.com/techbuzzz/Hercules.git && cd Hercules + +# Run CLI REPL + dotnet run --project src/agent/Hercules + +# Or run the agent with its web UI (single process — no second dev server) + dotnet run --project src/agent/Hercules.WebApi +``` + +The agent hosts the Studio SPA itself at
+
+ );
+}
diff --git a/examples/05-web-api-react/react-ui/src/index.css b/examples/05-web-api-react/react-ui/src/index.css
new file mode 100644
index 0000000..dda2123
--- /dev/null
+++ b/examples/05-web-api-react/react-ui/src/index.css
@@ -0,0 +1,16 @@
+@import "tailwindcss";
+
+body {
+ font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+}
+
+pre {
+ background: #171717;
+ padding: 0.75rem;
+ border-radius: 0.5rem;
+ overflow-x: auto;
+}
+
+code {
+ font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+}
diff --git a/examples/05-web-api-react/react-ui/src/main.jsx b/examples/05-web-api-react/react-ui/src/main.jsx
new file mode 100644
index 0000000..896930c
--- /dev/null
+++ b/examples/05-web-api-react/react-ui/src/main.jsx
@@ -0,0 +1,10 @@
+import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+import App from './App.jsx';
+import './index.css';
+
+createRoot(document.getElementById('root')).render(
+ Hercules React UI
+
+ {messages.map((m, i) => (
+
+
+
+ ))}
+ {loading && {m.role}
+
+ Hercules is thinking…
}
+
+ setInput(e.target.value)}
+ onKeyDown={e => e.key === 'Enter' && send()}
+ placeholder="Type a message…"
+ />
+
+
+