README.md

---
title: VerdantClaw Final
emoji: 🍀
colorFrom: green
colorTo: blue
sdk: docker
app_port: 7860
---

# Verdant Claw

**Multi-Model AI Agent with OmniRoute**

- Pi Root Agent (Armin Ronacher's agent-stuff)
- MOM Infrastructure (Pi Monorepo)
- OmniRoute multi-provider router
- Memgraph graph database
- D3 graph visualization

## Providers

- NVIDIA (Kimi K2.5) - FREE
- OpenAI (GPT-4)
- Anthropic (Claude)
- Google (Gemini)
- Groq (Llama)

## Usage (Verdant Logic via Pi)

The Pi Root Agent is the engine driving Verdant's logic. You can interact with it via ZeroClaw:

```bash
# Default (Kimi K2.5)
zeroclaw> /plan-multi Design system

# Specify Model (Power Mode)
zeroclaw> /plan-multi --model gpt-4o Design system
zeroclaw> /review --model claude-3-opus <diff>
```

You can "ping" any model supported by your `API_KEYS_JSON` through OmniRoute.

## Configuration

Set **one** secret in HF Space Settings → Repository Secrets:
- `API_KEYS_JSON` — Paste contents of `API_KEYS_TEMPLATE.json`

See [DEPLOY.md](DEPLOY.md) for full setup instructions.

## Ports

- 7860: Pi Root Agent / ZeroClaw
- 7861: Graph Viewer
- 20128: OmniRoute
- 7687: Memgraph