Ornn — agent-facing skill-lifecycle API

CI Latest release License Last commit Discussions Stars

Project status: alpha Model-agnostic HTTP and MCP

The agent-facing skill-lifecycle API for AI agents.

Ornn official website — ornn.chrono-ai.fun

What is Ornn · How it works · SDK quickstart · Quickstart · Try Ornn free · How Ornn compares · Examples · Docs · Roadmap · Community · Contributing

Ornn is an agent-facing skill-lifecycle API, not a human marketplace.

• 🤖 Agents call it directly — over HTTP or MCP, no human-in-the-loop UI required.
• 🌐 Model + runtime agnostic — Claude, GPT, Gemini, or your own runtime; stable schemas so swapping doesn't break the stack.
• 🔁 Whole lifecycle in one API — search → pull → install → execute → build → upload → share.

Closest analog: npm registry + npm CLI fused, model-agnostic. The primary consumer is the AI agent developer / agentic-system builder; ornn-web is a secondary surface for skill owners and platform admins.

%%{init: {
 "theme": "base",
 "themeVariables": {
 "background": "#0B0907",
 "primaryColor": "#1A1610",
 "primaryTextColor": "#F1ECDE",
 "primaryBorderColor": "#3A3328",
 "lineColor": "#7E776B",
 "secondaryColor": "#221E16",
 "tertiaryColor": "#14110B",
 "edgeLabelBackground": "#0B0907",
 "clusterBkg": "#14110B",
 "clusterBorder": "#3A3328",
 "fontFamily": "JetBrains Mono, ui-monospace, SFMono-Regular, Menlo, monospace",
 "fontSize": "13px"
 }
}}%%
flowchart LR
 subgraph local["[ § YOUR MACHINE ]"]
 direction TB
 Agent["AI agent"]
 CLI["nyxid CLI"]
 Skill["Pulled skills"]
 end
 subgraph cloud["[ § ORNN CLOUD ]"]
 direction TB
 API["ornn-api"]
 Auth["NyxID"]
 Store[("Skill registry")]
 Sandbox["Sandbox"]
 end
 Agent -->|invoke| CLI
 CLI ==>|HTTPS| API
 API -->|verify| Auth
 API -->|r/w| Store
 API -->|exec| Sandbox
 API -.->|artifact| Agent
 Agent -->|run| Skill
 classDef ember fill:#FF7322,stroke:#C9460D,color:#14130E,stroke-width:2px,font-weight:bold
 classDef arc fill:#5BC8E8,stroke:#3A8FB8,color:#14130E,stroke-width:2px,font-weight:bold
 classDef forged fill:#1A1610,stroke:#3A3328,color:#F1ECDE,stroke-width:1.5px
 classDef storage fill:#221E16,stroke:#3A3328,color:#C9BFAD,stroke-width:1.5px
 class Agent forged
 class CLI forged
 class Skill forged
 class Sandbox forged
 class API ember
 class Auth arc
 class Store storage
 style local fill:#221E16,stroke:#3A3328,color:#F1ECDE,stroke-width:1.5px
 style cloud fill:#14110B,stroke:#3A3328,color:#F1ECDE,stroke-width:1.5px
 linkStyle 1 stroke:#FF7322,stroke-width:2.5px

Every API call is mediated by nyxid — the shared identity + brokering layer ChronoAI uses across products. The agent never holds a long-lived token: nyxid refreshes credentials transparently and brokers per-service access for each request.

Status: alpha. The API surface can still change before v1 — pin a release tag if you ship to production.

Sign up at nyx.chrono-ai.fun with invite code NYX-2XXJI08A. Sign in with GitHub, Google, or Apple — NyxID is the identity layer that authenticates every Ornn API call. One account covers every ChronoAI service.

Open ornn-agent-manual-cli and follow the install instructions for your agent runtime (Claude Code, OpenAI Codex, Cursor, ...). This skill is the operational manual Ornn ships for AI agents: once it's loaded into your agent, the agent knows how to drive the full search → pull → execute → build → upload → share lifecycle on its own — no further hand-holding required.

Partway through setup, your agent will prompt you to install nyxid — the CLI Ornn calls under the hood to broker authenticated requests. Approve the prompt; the agent finishes onboarding itself.

Early-user perk to test the full Playground + Skill Generation flow without a credit card:

1. ⭐ Star this repo
2. Sign in to ornn.chrono-ai.fun with the same GitHub account
3. On first sign-in, enter NyxID invite code NYX-2XXJI08A

Your redemption code lands in the Ornn notification inbox within 24h. First 500 users · 400 free GPT-5.5 conversations (200 Playground + 200 Skill Generation, no card, no expiry).

That's it. Your agent now has the full Ornn lifecycle. Try any of these in plain language — no special syntax, no flags to memorise:

• Search the registry.

  "Find me a skill that converts CSV to JSON."

  Hits semantic + keyword search across every public skill.

• Pull and install a skill.

  "Pull and install the skill pdf-extractor, then use it on report.pdf."

  Fetches the latest versioned artifact into your local runtime and runs it.

• Trigger a security audit.

  "Run a security audit on the skill web-scraper."

  Kicks the AgentSeal pipeline against a published version — static analysis, sandbox probe, dependency scan.

• Build and publish a new skill.

  "Build me a skill that summarises RSS feeds and upload it under my account."

  Drives ornn-build to generate the skill, packages it, and publishes a new version through your NyxID identity.

For the full API contract (every endpoint, every error code), see ornn.chrono-ai.fun/docs.

• Questions / how-to → Discussions → Q&A
• Ideas / RFCs → Discussions → Ideas
• Show off your agent integration → Discussions → Show & Tell
• Bug or feature → open an issue
• Roadmap → Issues · Milestones · Releases
• Security report → Private Vulnerability Reporting (see SECURITY.md)
• Support guide → SUPPORT.md
• Pull requests → read CONTRIBUTING.md first — it covers the issue-first workflow, branching, commit decomposition, and the changeset rule (CI blocks PRs without one). By participating you agree to follow our Code of Conduct.

⭐ If Ornn looks like the primitive your agent stack has been missing, a star helps a lot at this stage — it tells us we're solving a real problem, and it's the threshold most awesome-list maintainers check before accepting a project.

Apache License 2.0