Skip to content

Repository files navigation

GoRaven

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.

Go React TypeScript Vite Tailwind CSS Docker License

Website · Live Preview · Discord · 中文

GoRaven Chat


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-first

Everyone 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 things

Agents 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 Marketplace

Prompts, 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 loop

Policies, docs, business materials go into RAG. Agents retrieve context in real time during execution. Answers have sources, not hallucinations.

🔌 Plugin Hooks

Before/after conversations, tool calls, SSE event streams — inject custom logic at any lifecycle point. Deep customization without forking core code.

🏠 Fully self-hosted

One 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


GoRaven Dashboard


Architecture

GoRaven 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


License

Apache-2.0

About

Open-source AI Agent platform for teams. Your agents don't just chat — they read files, run code, call APIs, and deliver results.

Topics

Resources

Stars

261 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages