• Overview
• Architecture
• Quick Start
• Key Features
• Project Structure
• Available Scripts
• Contributing
• Community
• Contributors
• Roadmap
• License

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.

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

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

# All contract tests
npx hardhat test

# Backend tests
cd backend && npm test

# Frontend tests
cd frontend && npm test

# SDK tests
cd sdk && npm test

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

• 🤖 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)

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

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.

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

See docs/FUNDING-REPORT.md for a full list of 78+ funding opportunities across 7 categories.

• Backend README — Express API, Prisma, Zod
• Frontend README — Next.js dashboard
• SDK README — @kuberna/sdk npm package
• Contracts README — Smart contract suite
• Examples — Agent template examples

We welcome contributions! See our Contributing Guide and Code of Conduct to get started.

Check out issues labeled good first issue for starter tasks.

Found something wrong? Open an issue.

Have an idea? Submit a feature request.

• 💬 Discord: Join the server — get help, share agents, meet the community
• 🐦 X (Twitter): @Arnaud_Kennedy
• 💬 GitHub Discussions: Join the conversation
• 📚 Documentation: Coming soon
• 🛡️ Security: Report vulnerabilities to security@kubernalabs.com

Thanks to everyone who has contributed to Kuberna Labs!

	Contributor	Role
	kawacukennedy	Creator & Lead
	lovewave02	Contributor
	KaustAbhinand	Contributor
	TiagooopNOC	Contributor

See CONTRIBUTORS.md for the full list.

If Kuberna Labs helps your project, please consider:

1. ⭐ Starring the repo — it helps others discover us
2. 💬 Joining the Discord — connect with other agent builders
3. 🐦 Following on X for updates
4. 💰 Sponsoring development via crypto or GitHub Sponsors

• Q3 2026: v1.0 Release — Mainnet contracts, production SDK, dashboard GA
• Q4 2026: Agent Marketplace — Community agent templates, strategy sharing
• Q1 2027: Cross-Chain Expansion — Solana, NEAR, Polkadot support
• Q2 2027: Enterprise — RBAC, audit logging, compliance reporting

MIT — see LICENSE.

Made with ❤️ by the Kuberna Labs team
_{If you like this project, ⭐ star it on GitHub !}