Kuberna Labs

July 15, 2026 · View on GitHub

Kuberna Labs

Agent Orchestration Platform — Deploy, run, and certify autonomous AI agents that execute cross-chain Web3 tasks.

⭐️ If you find this project useful, please star it on GitHub! ⭐️

It helps others discover the project and motivates contributors.

Kuberna Labs gives AI agents secure execution rails across any blockchain: agents parse natural language intents, make autonomous trading decisions, settle via on-chain escrow, and get post-quantum certified for verifiable reputation.

Target users: Web3 developers and teams who want to deploy autonomous AI agents that can trade, monitor, and execute on any chain without managing LLM infrastructure, blockchain RPCs, or certification pipelines.

✨ What Makes Kuberna Different?

Feature	Kuberna	Others
Natural Language → On-Chain Action	Parse "swap 1 ETH for USDC on Solana" → escrow → execution → certificate	Require manual intent encoding
Post-Quantum Certificates	SilentVerify certification for agents	No verifiable reputation
Cross-Chain by Default	Ethereum, Base, Polygon, Arbitrum, Solana	Usually single-chain
TEE Execution	Intel SGX enclave provisioning	No hardware-grade security
Local AI Mode	Zero-dependency intent parser, no API key needed	Require OpenAI/Gemini

Architecture

User Task ("swap 1 ETH for USDC on Solana")
  -> LLM Intent Parser (GPT-4 or local)
  -> Agent Decision Engine (arbitrage/yield/stop-loss)
  -> Intent Creation & On-Chain Escrow
  -> Task Completion -> SilentVerify Cert
  -> Reputation Update + Decision Trace

Package	Directory	Description
Backend API	`backend/`	Express + Prisma + Zod REST API (port 3000)
Frontend	`frontend/`	Next.js 14 dashboard with pages router
SDK	`sdk/`	`@kuberna/sdk` npm package for programmatic access
Smart Contracts	`contracts/`	Solidity contracts (Escrow, Intent, Registry, NFTs)
Prisma Schema	`prisma/`	Shared database schema and migrations

Quick Start

Prerequisites

Tool	Version
Node.js	>= 18.0.0 < 26.0.0
npm	>= 9.0.0
PostgreSQL	14+ (or Supabase free tier)
WalletConnect ID	Free from cloud.walletconnect.com

Setup in 2 Minutes

# 1. Clone and install
git clone https://github.com/kawacukennedy/kuberna-labs.git
cd kuberna-labs
npm install

# 2. Install workspace dependencies
cd backend && npm install && cd ..
cd frontend && npm install && cd ..
cd sdk && npm install && cd ..

# 3. Configure environment
cp backend/.env.example backend/.env
# Edit DATABASE_URL, JWT_SECRET (openssl rand -hex 32)

# 4. Set up database
cd backend && npx prisma migrate dev && cd ..

# 5. Compile smart contracts
npx hardhat compile

# 6. Start the backend (API on port 3000)
cd backend && npm run dev

# 7. In another terminal, start the frontend (port 3001)
cd frontend && npm run dev

Tip: Use docker-compose up for a fully local environment with PostgreSQL pre-configured.

Run Tests

# All contract tests
npx hardhat test

# Backend tests
cd backend && npm test

# Frontend tests
cd frontend && npm test

# SDK tests
cd sdk && npm test

Try the SDK

import { KubernaClient } from '@kuberna/sdk';

const client = new KubernaClient({
  apiKey: 'your-api-key',
});

// Create an agent with a natural language task
const task = await client.agents.createTask({
  intent: 'swap 1 ETH for USDC on Base when price > 3200',
  strategy: 'limit_order',
});

// Monitor execution
const result = await client.agents.waitForCompletion(task.id);
console.log('Task completed:', result.certificate);

Key Features

🤖 Autonomous Agent Orchestration — LLM-powered task execution with full decision tracing
🔤 Natural Language Intent Parsing — Parse "swap 1 ETH for USDC on Solana" into structured intents
📊 Agent Decision Engine — Arbitrage, yield optimization, and stop-loss strategies
🔒 On-Chain Escrow — Secure settlement with dispute resolution
🌉 Cross-Chain Intents — Multi-chain task creation and bidding marketplace
💸 Kite x402 Payments — Agent-controlled micro-payments via Kite protocol
🛡️ SilentVerify — Post-quantum certificate issuance for agents and chain state
🖥️ TEE Support — Intel SGX enclave provisioning for secure execution
⭐ Reputation System — On-chain agent reputation with ERC-8004 alignment
🧠 Local AI — Zero-dependency intent parser with RAG memory (no API key required)

Project Structure

kuberna-labs/
├── backend/                 # Express + Prisma API server
│   ├── src/
│   │   ├── index.ts         # Express entry point
│   │   ├── routes/          # REST API route handlers (19 modules)
│   │   ├── services/        # Business logic (agent, AI, payments, blockchain)
│   │   ├── middleware/       # Auth, validation, rate limiting, error handling
│   │   ├── validations/     # Zod schemas for request validation
│   │   └── utils/           # Prisma client, logger, ABIs
│   └── prisma/              # Schema reference
├── frontend/                # Next.js 14 dashboard
│   └── src/
│       ├── pages/           # App pages (agents, dashboard, courses, marketplace)
│       ├── components/      # Reusable UI (dashboard, layout, shared, Wallet)
│       ├── context/         # AuthContext provider
│       ├── hooks/           # Custom React hooks
│       ├── lib/             # Wagmi, viem, contract config
│       ├── services/        # Contract interaction services
│       └── styles/          # Tailwind CSS configuration
├── sdk/                     # @kuberna/sdk TypeScript SDK
├── contracts/               # Solidity smart contracts
│   ├── Escrow.sol           # Escrow with dispute resolution
│   ├── Intent.sol           # Cross-chain intent marketplace
│   ├── AgentRegistry.sol    # Agent identity and registry
│   ├── CertificateNFT.sol   # Course completion NFTs
│   ├── ReputationNFT.sol    # Agent reputation (ERC-8004 aligned)
│   ├── CrossChainRouter.sol # Cross-chain message passing
│   └── ...                  # Payment, Subscription, Treasury, etc.
├── prisma/                  # Shared Prisma schema + migrations
├── deployments/             # Deployed contract addresses per chain
├── scripts/                 # Hardhat deploy and setup scripts
├── test/                    # Hardhat contract tests
├── examples/                # Agent template examples
├── docs/                    # Additional documentation
├── packages/                # Internal packages (aip-adapter)
├── hardhat.config.ts        # Hardhat configuration
├── docker-compose.yml       # Local Docker setup
└── render.yaml              # Render blueprint deployment

Available Scripts

Script	Description
`npm run dev`	Start frontend dev server
`npm test`	Run Hardhat contract tests
`npm run compile`	Compile Solidity contracts
`npm run build:all`	Build SDK, backend, and frontend
`npm run format`	Format code with Prettier
`npm run lint`	Lint TypeScript with ESLint
`npm run db:deploy`	Deploy Prisma migrations
`npm run db:generate`	Generate Prisma client
`npm run deploy:sepolia`	Deploy contracts to Sepolia
`npm run deploy:base`	Deploy contracts to Base Sepolia

Deployment

Production URL: https://kuberna-labs.onrender.com

Kuberna is deployed on Render (starter plan, Oregon) via render.yaml (Blueprint). Auto-deploys on push to main. Health check: GET /health.

Production Environment Variables

Variable	Description
`DATABASE_URL`	Supabase transaction pooler URL
`DIRECT_URL`	Supabase direct URL for migrations
`JWT_SECRET`	JWT signing key
`JWT_REFRESH_SECRET`	JWT refresh key
`ALLOWED_ORIGINS`	CORS allowlist
`NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID`	WalletConnect Cloud project ID
`RPC_URL`	Blockchain RPC endpoint
`PRIVATE_KEY`	Backend wallet private key
`AI_API_KEY`	Virtuals ACP API key (AI backend)
`AI_BASE_URL`	Virtuals compute endpoint
`AI_MODEL`	LLM model (Claude Opus 4)

Optional: STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, REDIS_URL, SMTP_* for extended features.

Sponsor	Status	What It Powers
Virtuals	✅ Live	LLM backend (Claude Opus 4 via ACP)
Pyth Network	✅ Live	Price oracle (ETH, BTC, USDC)
Discord	✅ Live	CI notifications + GitHub star alerts
Stripe	🔧 Code ready	Fiat payments + subscriptions (needs API key)
Kite AI	🔧 Code ready	Agent payments (x402 protocol)
SilentVerify	🔧 Code ready	Post-quantum agent PKI
Infura / Alchemy	✅ Local	RPC providers for contract deployment