How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

Nerv - Skill - OpenSmartRoute

Imported from IShinji/Nerv (AGENTS.md). Install upstream with npx skills add IShinji/Nerv. Copyright stays with the author.

Nerv — Agent Instructions (for Codex / AI Coding Tools)

Read and follow CONVENTIONS.md for all code style, naming, and project structure rules.

Project Overview

Nerv is a personal AI operating system. Architecture: Rust core + Python brain + Tauri GUI (later).

core/ — Rust: Gateway (channel adapters), hardware detection, process management
brain/ — Python: Router, Orchestrator, Agent Factory, Context Manager, Memory, Tools
agents/ — YAML agent definitions
gui/ — Tauri + React (Phase 2, not yet)

Communication

Rust ↔ Python: JSON-RPC 2.0 over stdin/stdout, newline-delimited.

Critical Design Rules

Router MUST use local Ollama model (not paid API) — token cost is the #1 concern
Gateway MUST use ChannelAdapter trait — never hardcode Telegram logic in core
All messages MUST convert to unified Message format
Agent definitions MUST be YAML files, not Python code
NEVER send full conversation history to LLMs — use rolling summaries

Code Style

See CONVENTIONS.md for complete rules. Summary:

Rust: rustfmt + clippy, snake_case functions, PascalCase types, async tokio, thiserror + anyhow
Python: ruff format + check, type hints required, dataclass/Pydantic for data, asyncio
Git: feat: / fix: / refactor: prefix, English, lowercase

# after Install: the listing is in your workspace's routing pool - a plan picks it for its slot curl -s -X POST https://api.opensmartroute.ai/api/v1/route -H 'Authorization: Bearer $OSR_API_KEY' -H 'Content-Type: application/json' -d '{"text": "...", "plan": true}'

Install Nerv and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

Nerv

About

Nerv — Agent Instructions (for Codex / AI Coding Tools)

Project Overview

Communication

Critical Design Rules

Code Style

Use it

Install Nerv and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Manifest

Reviews