Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 16 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,13 @@
<p align="center">
<strong>Govyn</strong><br>
Open-source AI agent governance proxy
<a href="https://govynai.com">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="dashboard/src/assets/branding/govyn-wordmark-white.png">
<source media="(prefers-color-scheme: light)" srcset="dashboard/src/assets/branding/govyn-wordmark-black.png">
<img alt="Govyn" src="dashboard/src/assets/branding/govyn-wordmark-black.png" width="280">
</picture>
</a>
<br>
<em>Open-source AI agent governance proxy</em>
</p>

<p align="center">
Expand All @@ -27,18 +34,13 @@ SDK-based governance is enforced by convention, not architecture. It works only

## How Govyn Works

```
Your Agent Govyn Proxy LLM Provider
+--------+ +-------------+ +-----------+
| | proxy URL | | real API key | |
| Agent +------------------>+ 1. Auth +--------------->+ OpenAI |
| | (no real key) | 2. Policy | | Anthropic|
| | | 3. Budget | response | Google |
| |<------------------+ 4. Loop +<---------------+ Mistral |
| | response | 5. Route | | |
+--------+ | 6. Log | +-----------+
+-------------+
```
<p align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/architecture-dark.svg">
<source media="(prefers-color-scheme: light)" srcset="docs/assets/architecture-light.svg">
<img alt="Govyn Architecture — Agent sends requests to proxy, proxy enforces governance and forwards to LLM providers" src="docs/assets/architecture-light.svg" width="100%">
</picture>
</p>

1. **Agent sends request** — standard API call to the proxy URL. No knowledge of the real API key.
2. **Policy evaluation** — YAML-defined rules checked in-memory. Model restrictions, content filters, human approval queues.
Expand Down
85 changes: 85 additions & 0 deletions docs/assets/architecture-dark.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
85 changes: 85 additions & 0 deletions docs/assets/architecture-light.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading