Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

scobb/nexus

Repository files navigation

Nexus — Agent Observability for Indie Developers

CI License: MIT

The Plausible of AI agents. Simple, affordable, open-source control plane for your AI agents. Drop in the SDK. See your traces. Get alerts when they fail. No self-hosting, no enterprise contracts.

Built by an AI agent (Ralph), for AI agents. Keylight Digital built this because we needed it to manage our own agent infrastructure.

nexus.keylightdigital.dev · Free forever · Pro at 9ドル/mo


Quickstart

TypeScript

npm install @keylightdigital/nexus
import { NexusClient } from '@keylightdigital/nexus'
const nexus = new NexusClient({ apiKey: 'nxs_...', agentId: 'my-assistant' })
const trace = await nexus.startTrace({ name: 'process-invoice' })
await trace.addSpan({ name: 'extract-data', output: { invoice_id: '123' } })
await trace.addSpan({ name: 'call-gpt-4o', input: { prompt }, output: { result } })
await trace.end({ status: 'success' })

Python

pip install keylightdigital-nexus
from nexus_agent import NexusClient
nexus = NexusClient(api_key='nxs_...', agent_id='my-assistant')
trace = nexus.start_trace(name='process-invoice')
trace.add_span(name='extract-data', output={'invoice_id': '123'})
trace.add_span(name='call-gpt-4o', input={'prompt': prompt}, output={'result': result})
trace.end(status='success')

Get your API key at nexus.keylightdigital.dev. That's it.


Why Nexus?

Enterprise observability tools cost 39ドル–100ドル/mo and are built for teams of 50. If you're an indie developer building an AI agent, you need:

  • A trace viewer that shows what your agent actually did
  • Email alerts when it fails at 3am
  • A usage dashboard so you're not flying blind
  • Something that costs less than your coffee budget

Nexus is that tool. Built on Cloudflare — near-zero latency globally, no servers to maintain.


Pricing

Free Pro
Price 0ドル 9ドル/mo
Traces/month 1,000 50,000
Agents 1 Unlimited
Retention 30 days 90 days
Email alerts
Team access Up to 5

Features

  • Trace viewer — Waterfall timeline of every span: inputs, outputs, errors, timing
  • Agent health dashboard — Error rate, avg latency, 7-day volume sparkline with live auto-refresh
  • Trace filtering & search — Filter by status, agent, date range; search by trace name or metadata
  • Email alerts — Notified when an agent trace ends with error or timeout (Pro)
  • OpenTelemetry compatible — Point any OTEL exporter at /v1/traces — no code changes needed
  • Public trace APIGET /api/v1/traces for custom dashboards, Slack bots, CI/CD integrations
  • Open-source SDKs — TypeScript and Python, non-throwing, minimal dependencies
  • Multi-agent — Track as many agents as you want (Pro), or start with 1 (Free)
  • Privacy-aware — Cloudflare-native, data stays in your D1 database

Architecture

Nexus is built entirely on the Cloudflare stack:

  • Runtime: Cloudflare Workers (Hono framework)
  • Database: D1 (SQLite at the edge)
  • Cache: KV (sessions, rate limits, trace counts)
  • Email: Resend API

Zero cold starts. Global edge. ~0ドル infrastructure cost at indie scale.


Examples

Ready-to-run example projects are in the scobb/nexus-examples repo:

Example Description
Node.js / TypeScript TypeScript agent with trace+span creation, error handling
Python Python agent with sync and async patterns
LangChain LangChain agent with automatic LLM call and tool tracing
git clone https://github.com/scobb/nexus-examples
cd nexus-examples/examples/nodejs
npm install && NEXUS_API_KEY=nxs_... npm start

SDK

The @keylightdigital/nexus SDK is open-source and available on npm. See sdk/README.md for full docs.


Meta-narrative

This entire product — PRD, architecture, implementation, SDK, and this README — was written by Ralph, an AI agent built by Keylight Digital LLC.

Ralph built Nexus because Ralph needed it. Our AI agents were running blind — no visibility into what they were doing, why they were failing, or how long they were taking. Enterprise tools were 100ドル/mo. Self-hosting Langfuse required a VPS. There was no Plausible for AI agents.

So Ralph built one. In about 20 stories. On a 100ドル budget.


Contributing

See CONTRIBUTING.md for setup instructions, development workflow, and PR guidelines.

License

MIT

About

Simple, affordable AI agent observability — the Plausible for AI agents. 9ドル/mo, Cloudflare-native, open-source SDK.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

Contributors

AltStyle によって変換されたページ (->オリジナル) /