Ornn

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

---

What is Ornn

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.

How it works

%%{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.

Quickstart

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

1. Create a NyxID account

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.

2. Install the Ornn agent manual into your AI agent

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.

Try Ornn free

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).

How Ornn compares

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.

Community and Contributing

• 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](SECURITY.md))
• Support guide → [SUPPORT.md](SUPPORT.md)
• Pull requests → read [CONTRIBUTING.md](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](CODEOFCONDUCT.md).

Like what you see?

⭐ 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.

License

[Apache License 2.0](LICENSE)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ChronoAIProject
• Source: ChronoAIProject/Ornn
• License: Apache-2.0
• Homepage: https://ornn.chrono-ai.fun

Install and usage instructions live in the source repository linked above.