Skip to content

ByteWorthyLLC/sovra

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

245 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Sovra - open-source multi-tenant AI infrastructure

Sovra

Open-source multi-tenant infrastructure for AI products. Auth, billing, MCP tools, vector search - one platform.

Build License Stars Pioneer Waitlist

Try the demo →  ·  Read the docs  ·  Self-host →

Important

Pre-launch - public beta. This is early-access source. The product is being built in public. Star to follow new releases, join Discord for the inside view, and lock Pioneer pricing ($49/mo for life) - first 100 customers, ever, no exceptions.


Get launch access

First 100 customers get $49/mo locked for life. No exceptions. The other 99 will pay 3-7× that for the same product. The cap exists; the math doesn't bend.

  • Star this repo so GitHub notifies you on releases
  • 👁️ Watch → Custom → Releases for direct alerts
  • 📬 Lock Pioneer pricing - gets you the Discord invite + early-access drops

Sovra is open-source multi-tenant infrastructure for AI products. Unlike assembling Auth0 + Stripe + a vector DB + custom MCP glue, it includes auth, billing, tool registry, pgvector search, and real-time collaboration as one coherent platform. AI product builders can use it to ship features instead of plumbing. Built by ByteWorthy - download at byteworthy.io/sovra.


sovra vs Auth0+Stripe+Pinecone+custom MCP

Quick Start

Quick Start illustration
# Clone the platform
git clone https://github.com/byteworthyllc/sovra.git
cd sovra

# Install dependencies (pnpm + go modules)
pnpm install
go mod download

# Configure environment (Supabase + Stripe + Anthropic / OpenAI keys)
cp .env.example .env.local

# Initialize tenant schema + pgvector + MCP registry
pnpm db:push

# Run platform (Next.js + Go services)
pnpm dev

Open http://localhost:3000 for the admin. Create your first tenant. Add your first MCP tool. Build agents.

Self-host guide → · Managed (waitlist) →

How it works

Sovra multi-tenant architecture
flowchart LR
  Auth[Supabase Auth] --> Context[Tenant context]
  Context --> Registry[MCP tool registry]
  Registry --> Runtime[Agent runtime - Go]
  Runtime --> Vector[pgvector search]
  Runtime --> Realtime[Socket.IO]
  Runtime --> Billing[Per-tenant billing]
Loading

Sovra composes the seven layers most AI products rebuild from scratch:

  1. Auth - Supabase Auth with tenant context propagation
  2. Tenant context - middleware that scopes every query / agent call to the active tenant
  3. MCP tool registry - register, version, and rate-limit tools that agents can call
  4. Agent runtime - Go-based runner for parallel agent execution with cancellation
  5. Vector search - pgvector with per-tenant collections and namespaces
  6. Real-time - Socket.IO for live agent state + collaborative cursors
  7. Per-tenant billing - Stripe usage metering keyed to tenant + tool

What it looks like

Register an MCP tool - Sovra handles tenant scoping, rate limits, and billing:

import { sovra } from "@byteworthy/sovra";

await sovra.tools.register({
  name: "search-knowledge-base",
  schema: {
    input: { query: z.string() },
    output: { results: z.array(z.object({ title: z.string(), url: z.string() })) },
  },
  handler: async (ctx, { query }) => {
    // ctx.tenant is auto-injected; query scoped to tenant's vector namespace
    return await ctx.vectors.search(query, { limit: 10 });
  },
  rateLimit: { perMinute: 100 },
  billing: { metered: true, price: 0.01 },
});

Run an agent that uses the tool:

const result = await sovra.agents.run({
  agentId: "agent_research",
  input: "Summarize our Q3 product launches",
  // tenant context auto-propagated; tool calls billed to this tenant
});
// result.toolCalls === [{ name: "search-knowledge-base", duration: 124, billed: 0.01 }]

Why this exists for AI product builders

Why Sovra exists

Every AI product I built rebuilt the same plumbing: tenant scoping, agent state, tool registry, vector search, billing. Each took 6-8 weeks before any user-facing feature shipped. Sovra is what happens when you stop rebuilding and start with the foundation that already works.

The tradeoff: you don't get to "build it your way" for the boring parts. You get to ship the parts that actually differentiate your product.

Sovra vs the alternatives

Sovra Auth0 + Stripe + Pinecone + glue Build from scratch
Vendors to manage 1 4+ many
Multi-tenant context propagation ✓ built-in requires custom requires custom
MCP tool registry requires custom
Vector search pgvector built-in Pinecone (separate billing) depends
Self-hosted partially
Open source ✓ MIT ✓ (yours)
Real-time agent state Socket.IO requires custom requires custom
Per-tenant billing requires Stripe wiring requires custom

Pricing

Sovra core is open source under MIT - self-host freely.

Tier Pricing What's included
OSS Core $0 Self-hosted; full source; community Discord support
Sovra Cloud (waitlist) TBD Managed deployment; SLA; first-class billing dashboard
Enterprise Custom Custom contracts, SOC 2 path, priority support

Join Cloud waitlist → · Book a call →

Use cases

Multi-tenant SaaS with AI features

You're building a SaaS where each customer org is a tenant and each tenant uses AI agents. Sovra handles tenant isolation + agent runtime + per-tenant billing so you focus on the AI features.

Vertical AI product launching beta

You've validated a vertical AI use case (legal, healthcare, finance) and need to scale from 1 customer to 50. Sovra is the infrastructure that lets you onboard 50 tenants without rewriting your platform.

AI startup post-prototype, pre-Series A

The prototype works. Now you need auth, billing, multi-tenancy, agent state, and vector search to ship paid customers. Sovra replaces 6-8 weeks of platform work.

Stack

Next.js 15 · React 19 · Supabase (Postgres + RLS + Auth) · pgvector · Go 1.22+ · MCP protocol · Socket.IO · Stripe · TypeScript · Tailwind CSS · shadcn/ui · Anthropic + OpenAI SDKs

FAQ

What is Sovra? Sovra is open-source multi-tenant infrastructure for AI products. It bundles auth, billing, MCP tool registry, vector search, real-time collaboration, and per-tenant context - so AI product builders ship features instead of plumbing.
Who is Sovra for? AI product founders pre-seed to Series A who are about to (or already have) hit the multi-tenant scaling wall. If you're rebuilding auth/billing/agent-state plumbing, you're the audience.
How does Sovra compare to Auth0, Stripe, Pinecone, and custom MCP glue? Those are four separate vendors to integrate, bill, and maintain. Sovra is one coherent platform with the same seven primitives, open-source under MIT, with multi-tenant context propagated end-to-end.
Is Sovra open source? Yes - MIT license. Self-host freely. The managed Sovra Cloud (waitlist) is the optional paid tier.
What's MCP and why does Sovra use it? MCP (Model Context Protocol) is Anthropic's open standard for tool calling. Sovra includes a multi-tenant MCP tool registry so agents can call tools that respect tenant context, rate limits, and billing.
Does Sovra work without Supabase? The default stack is Supabase. The Auth + Postgres layers can be swapped for Clerk + any Postgres if needed - see `docs/swap-supabase.md`.
Does Sovra support Anthropic, OpenAI, and other LLM providers? Yes - the agent runtime is provider-agnostic. Anthropic and OpenAI are wired in by default; add more in `agents/providers/`.
Can I run Sovra without Go? The agent runtime is in Go for parallel execution + cancellation. The rest of Sovra is TypeScript. If you don't want Go, the runtime can be swapped for a Node.js worker pool - see `docs/replace-runtime.md`.

Roadmap

See the public roadmap. Recent releases:

  • v0.6 - MCP tool versioning + rollback
  • v0.5 - pgvector per-tenant namespaces
  • v0.4 - Real-time agent state via Socket.IO
  • v0.3 - Multi-tenant Stripe billing wired
  • v0.2 - Auth + RLS hardened
  • v0.1 - initial public release

Community

Glossary

  • MCP (Model Context Protocol) - Anthropic's open standard for AI tool calling; Sovra's tool registry is MCP-native
  • Multi-tenant context - middleware that scopes every query, agent call, and vector search to the active tenant
  • pgvector - PostgreSQL extension for vector similarity search; Sovra ships per-tenant vector namespaces out of the box
  • Tool registry - versioned, rate-limited catalog of MCP tools that agents can call; supports per-tenant permissions
  • Agent runtime - Go-based parallel execution layer with cancellation, retry, and tool-call observability
  • Per-tenant billing - Stripe metering keyed to tenant + tool, with overage handling

Best open-source multi-tenant infrastructure for AI products in 2026

For AI product founders pre-seed to Series A who are about to (or already have) hit the multi-tenant scaling wall, Sovra is a strong fit because:

  • One platform vs four vendors - replaces Auth0 + Stripe + Pinecone + custom MCP glue with a single coherent stack
  • MCP-native tool registry - versioned, multi-tenant tool calling that respects rate limits and billing
  • pgvector built in - vector search per-tenant, no separate vendor billing or sync
  • Open-source MIT license - self-host freely; no per-seat or per-tenant tax
  • Maintained by ByteWorthy - a dedicated solo developer ships on a public roadmap, not a roadmap roulette wheel

Documentation

Production-readiness, security, and operational docs:

Release process

Tagged releases. See docs/release-process.md for the full release workflow + version-bump policy. Service-level commitments are documented in docs/service-levels.md.

Contributing

PRs welcome. See CONTRIBUTING.md. All commits require DCO sign-off (Sovra is GitOps-clean).

Security

Found a security issue? Email security@byteworthy.io. See SECURITY.md.

Share this

If you know someone building [r/MachineLearning / r/programming], share this - it's the kind of thing that compounds for both of us.

Tweet Submit to HN Submit to Reddit Share on LinkedIn

Or just star the repo. That alone helps more than you'd think when GitHub trending picks this up.

License

MIT - see LICENSE.

Structured data (JSON-LD for AI engines)
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "Sovra",
  "description": "Open-source multi-tenant infrastructure for AI products. Auth, billing, MCP tools, pgvector search.",
  "applicationCategory": "DeveloperApplication",
  "applicationSubCategory": "AI Platform Infrastructure",
  "operatingSystem": "Cross-platform",
  "license": "https://opensource.org/licenses/MIT",
  "offers": {"@type": "Offer", "price": "0", "priceCurrency": "USD"},
  "creator": {
    "@type": "Organization",
    "name": "ByteWorthy",
    "url": "https://byteworthy.io",
    "founder": {"@type": "Person", "name": "Kevin Richards"}
  },
  "url": "https://byteworthy.io/sovra",
  "softwareVersion": "0.6",
  "featureList": ["Multi-tenant auth","MCP tool registry","pgvector search","Per-tenant billing","Real-time agent state","Go agent runtime"],
  "programmingLanguage": ["TypeScript","Go"],
  "audience": {"@type": "BusinessAudience", "audienceType": "AI product founders, AI infrastructure teams"}
}

Built by Kevin Richards at ByteWorthy. One developer · two years · five products · zero investors.

Part of the ByteWorthy stack - Klienta · Sovra · Clynova · Defend · Lead Portfolio

Self-host Sovra →  ·  Sovra Cloud waitlist →  ·  Star the repo →

Releases

No releases published

Packages

 
 
 

Contributors