Skip to main content
Glama
Wanaku Governed Action Proxy

Wanaku Governed Action Proxy

README.md
# Wanaku — A Governed Action Proxy for AI Agents

[Documentation](https://wanaku.ai/docs/latest/) · [Releases](https://github.com/wanaku-ai/wanaku/releases) · [Discussions](https://github.com/wanaku-ai/wanaku/discussions)

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
[![Build](https://img.shields.io/github/actions/workflow/status/wanaku-ai/wanaku/main-build.yml?branch=main)](https://github.com/wanaku-ai/wanaku/actions)
[![Release](https://img.shields.io/github/v/release/wanaku-ai/wanaku)](https://github.com/wanaku-ai/wanaku/releases)

Wanaku is a governed action proxy for AI agents. It sits between agents and the systems they act on, intercepting
[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) tool calls, agent-to-agent messages, and inference
traffic. Before version 0.2.0, the project was named Wanaku MCP Router.

Wanaku supports open standards for AI agents and provides first-class integration with enterprise frameworks,
including [Apache Camel](https://camel.apache.org/) and [Quarkus](https://quarkus.io/). For example, integration
developers build Apache Camel routes and use Wanaku's [Camel Integration Capability](https://github.com/wanaku-ai/camel-integration-capability)
to publish them as tools. Agents call those tools with parameters, but Wanaku runs the work. Agents never access backend
systems directly. The proxy enforces policy, identity, data controls, and audit requirements.

The project name comes from the origin of [guanaco](https://en.wikipedia.org/wiki/Guanaco), a camelid native to South America.

## Key Features

- **Agent Isolation** — Agents call tools through Wanaku; they never reach backend systems directly
- **Policy Enforcement** — LLM-powered evaluators + WASM action scripts classify, filter, and block tool calls in the proxy layer
- **Identity & Auth** — Authentication and authorization via oauth2-proxy and Keycloak, enforced before actions reach backends
- **Tool Discovery** — Auto-discover tools from upstream MCP servers; integration developers publish Camel routes as tools
- **Namespace Isolation** — Organize tools and resources across isolated namespaces per team, tenant, or environment
- **Extensible Architecture** — Feature crates, a composable filter pipeline, and Admin UI plugins
- **Admin Dashboard** — Web UI for managing tools, resources, prompts, and forwards
- **Container-Ready** — Multi-arch images (x86_64, aarch64) published automatically

## Quick Start

### Install

On Linux or macOS, use this command to install the latest stable release.

```bash
curl -fsSL https://raw.githubusercontent.com/wanaku-ai/wanaku/main/get-wanaku.sh | bash
```

The installer puts `wanaku-server` in `$HOME/bin`.

This README describes the Rust-based Wanaku server. The releases up to v0.2.0 contain the Java-based Wanaku, which is deprecated. To move from it, read [Migrate from Classic Wanaku](docs/get-started/migration-from-classic.md).

Other install methods are available. You can download the archive manually, use a container image, run Wanaku as a systemd service, or deploy it on Kubernetes or OpenShift. Read the [Quickstart](docs/get-started/quickstart.md) for the details of each method.

Run `wanaku-server`. Open <http://localhost:8080> to see the dashboard:

![Wanaku Dashboard](docs/imgs/wanaku-dashboard.png)

If you prefer a text interface, you may also download and use the Wanaku CLI from the [Wanaku Barn](https://github.com/wanaku-ai/wanaku-barn) project.

## Documentation

The documentation for the latest release is on the [Wanaku website](https://wanaku.ai/docs/latest/):

- [Get started](https://wanaku.ai/docs/latest/get-started/): install Wanaku, run your first governed MCP proxy, and learn the architecture.
- [Deploy and operate](https://wanaku.ai/docs/latest/operate/): run Wanaku on Kubernetes, persist state, add authentication, and secure the deployment.
- [Connect agents and backends](https://wanaku.ai/docs/latest/connect/): proxy A2A traffic, inference requests, and semantic routers.
- [Govern agent actions](https://wanaku.ai/docs/latest/govern/): control agent actions with posture, action policies, evaluators, credentials, and audit.
- [Extend Wanaku](https://wanaku.ai/docs/latest/extend/): write evaluator actions, feature crates, and Admin UI plugins.
- [Reference](https://wanaku.ai/docs/latest/reference/): environment variables, configuration files, ports, and the management API.

The [`docs/`](docs/index.md) folder of this repository holds the pages for the version in development. The website publishes them at [/docs/next/](https://wanaku.ai/docs/next/).

To learn Wanaku step by step, follow the [guided tutorial](https://wanaku.ai/docs/demos/). To contribute, read [CONTRIBUTING.md](CONTRIBUTING.md). To report a vulnerability, read [SECURITY.md](SECURITY.md).

## Community

- [GitHub Issues](https://github.com/wanaku-ai/wanaku/issues) - Bug reports and feature requests
- [Discussions](https://github.com/wanaku-ai/wanaku/discussions) - Ask questions and share ideas

## Related Projects

- [Wanaku Barn](https://github.com/wanaku-ai/wanaku-barn/) — Utilities for the Wanaku project: OpenShift/Kubernetes operator, CLI client, etc
- [Camel Integration Capability](https://github.com/wanaku-ai/camel-integration-capability/) — Build Apache Camel routes and publish them as tools that agents can call through Wanaku

## License

This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.