GoRaven
Open Source · Self-Hosted · AI Harness
Models, tools, knowledge, skills, workflows — all in one runtime. The Agent doesn't just chat. It actually gets work done.
Website · Live Preview · Discord · 中文
What It Is
GoRaven gives every person on your team an independent Agent workspace. Not a chat window — a workstation. The Agent reads files, writes code, runs commands, calls APIs, searches your knowledge base, analyzes data, writes reports, builds charts. You assign the task; it breaks it down, works in parallel, and delivers the result.
What you get is the outcome, not a block of text you have to copy-paste.
Why GoRaven
🎯 Team-firstEveryone gets an isolated workspace. The team shares projects and skill libraries. Admins control model quotas, tool permissions, and data access. Not a single-player toy. |
🔧 Actually does thingsAgents directly read/write files, run Shell, call MCP tool chains. Internal APIs, databases, private services — plug them all in. Not just another suggestion paragraph. |
🧩 Skill MarketplacePrompts, scripts, workflows packaged as skills. One-click install, centralized maintenance. One person hits a wall — the whole team skips it next time. |
📚 Knowledge in the loopPolicies, docs, business materials go into RAG. Agents retrieve context in real time during execution. Answers have sources, not hallucinations. |
🔌 Plugin HooksBefore/after conversations, tool calls, SSE event streams — inject custom logic at any lifecycle point. Deep customization without forking core code. |
🏠 Fully self-hostedOne Docker command and it's running. Data never leaves your server. Works with OpenAI, Claude, DeepSeek, Qwen, GLM, or any compatible API. |
Quick Start
docker pull 8treenet/goraven:latest
docker run -d --restart=always --name goraven-agent \
-p 8000:8000 \
8treenet/goraven:latest
Persistent Data
docker run -d --restart=always --name goraven-agent \
-p 8000:8000 \
-v /opt/goraven:/goraven/data \
8treenet/goraven:latest
After startup, visit http://localhost:8000 and follow the setup wizard to create your admin account.
The container uses UTC by default. To set a different timezone, add
-e TZ=America/New_York. Available timezones: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
Architecture
Design Principles
The model is the Way; the Agent is the instrument. The Way evolves on its own — the instrument need only be precise.
We don't do "memory and evolution" — if it can't be distilled into generalizable rules or real-time retrieval augmentation, it's just noise. The model's evolution is the model's own business; the Agent shouldn't overstep.
As a tool, the Agent has only three duties: deterministic workflows, precise tool invocation, and robust execution. Borrow the instrument to let wisdom arise naturally — a true instrument is one that fulfills its purpose to the fullest.
Observability First: Collaboration isn't about delegating tasks — it's about aligning understanding. Human-agent communication is far more fragile than human-human communication: you can't see what it's thinking, and it can't guess what you want. Observability of the execution process must be pursued and solved at the product level — every round of observation should become the reserve for the next round of decisions.
OS First: Models have knowledge and reasoning, but no eyes and no hands. For an Agent to get work done, it must heavily leverage operating system capabilities. But an Agent can't come with a full OS — so integrating runtime environments and dependencies must be the first priority. This isn't something code or algorithms alone can solve. A good Agent is, at its core, an Agent OS — except you can't actually build an operating system from scratch.
Engineering First: Agents are too flexible — tool combinations explode fast, and tweaking a pruning rule even slightly sends the whole execution flow off track. Without solid engineering, a few iterations in and nobody dares to touch it. The time spent on engineering isn't about shipping one more feature today. It's about making sure the project is still worth working on next year.
Community
- 💬 Discord — feedback, discussions, tips
- 🌐 goraven.dev — Website
- 🚀 preview.goraven.dev — Live preview