CORGENTIC

AI Agent Economic Operating Layer on Solana — A comprehensive full-stack platform for deploying, managing, and monetizing AI agents on Solana blockchain.

Build, deploy, and earn with AI agents on Solana

Overview

CORGENTIC is a modular, open-source monorepo providing a complete ecosystem for AI agents:

• 🎯 Dashboard — Web interface for agent management and marketplace
• 🔌 API Server — RESTful backend for agent lifecycle management
• 💻 CLI — Command-line tools for deployment and configuration
• 📦 SDK — JavaScript/TypeScript client library
• 🗄️ Database — Drizzle ORM schema and migrations
• ⚙️ Shared Libraries — API specs, validation, and React hooks

Tech Stack

• Frontend: React, TypeScript, Vite, Tailwind CSS
• Backend: Express.js, TypeScript, Pino logging
• Database: Drizzle ORM with PostgreSQL support
• Auth: Privy for Web3 authentication
• Blockchain: Solana ecosystem
• Package Manager: pnpm workspaces
• Runtime: Node.js >=18.17.0

Project Structure

corgentic/
├── artifacts/
│   ├── api-server/          # Express API server
│   └── cogentic/            # React web dashboard
├── lib/
│   ├── api-client-react/    # React hooks for API integration
│   ├── api-spec/            # API type specifications
│   ├── api-zod/             # Zod validation schemas
│   └── db/                  # Database schema & migrations
├── packages/
│   ├── cli/                 # Command-line interface
│   └── sdk/                 # JavaScript/TypeScript SDK
└── scripts/                 # Build and utility scripts

Getting Started

Prerequisites

• Node.js: >=18.17.0
• pnpm: >=8.15.0

Installation

# Clone the repository
git clone https://github.com/corgentic-dev/corgentic.git
cd corgentic

# Install dependencies
pnpm install

Development

# Start all services in development mode
pnpm dev

# Or start individual services:
pnpm dev:api    # API server on http://localhost:8080

Build

# Build all packages
pnpm build

# Type checking
pnpm type-check

# Linting
pnpm lint

# Testing
pnpm test

# Clean build artifacts
pnpm clean

Packages

API Server (artifacts/api-server)

Express.js server providing RESTful API endpoints for agent management, fee routes, marketplace, treasury, and token operations.

Key Routes:

• /agents — Agent management
• /marketplace — Agent marketplace
• /tokens — Token operations
• /treasury — Treasury management
• /fee-routes — Fee configuration
• /health — Health checks

Features:

• CORS and rate limiting middleware
• Authentication via Privy
• Structured logging with Pino
• Helmet security headers

Start Development:

pnpm dev:api

Web Dashboard (artifacts/cogentic)

React-based dashboard providing UI for:

• Agent registry and management
• Marketplace publishing
• Token launches
• Dashboard analytics
• Documentation and API references

Start Development:

pnpm dev:web

CLI (packages/cli)

Command-line interface for managing CORGENTIC agents:

corgentic agent [command]      # Agent operations
corgentic marketplace [cmd]    # Marketplace actions
corgentic token [command]      # Token management
corgentic treasury [command]   # Treasury operations
corgentic deploy [command]     # Deploy agents
corgentic login                # Authenticate

SDK (packages/sdk)

JavaScript/TypeScript client library for programmatic access:

import { CorgenticClient } from '@corgentic/sdk';

const client = new CorgenticClient({
  baseURL: 'https://api.corgentic.com'
});

// Use SDK for agent management, marketplace, tokens, etc.

Database (lib/db)

Drizzle ORM configuration and schema definitions for:

• Agent records
• Marketplace listings
• Treasury transactions
• Token data
• User profiles

Setup:

cd lib/db
pnpm migrate

Shared Libraries

• api-client-react — React hooks for API integration (useAgents, useMarketplace, useTokens, etc.)
• api-spec — Centralized API type definitions
• api-zod — Zod schemas for runtime validation

Key Features

✨ Agent Management — Deploy and manage AI agents on Solana

💰 Marketplace — Publish and discover agents with monetization

🪙 Token Launch — Create and manage agent tokens

💳 Fee Routes — Configure and track fee distribution

🏛️ Treasury — Manage collective treasury and rewards

🔐 Web3 Auth — Privy-powered wallet authentication

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Scripts

pnpm dev           # Start all services
pnpm dev:api       # Start API server
pnpm dev:web       # Start web dashboard
pnpm build         # Build all packages
pnpm type-check    # TypeScript type checking
pnpm lint          # Run ESLint
pnpm test          # Run tests
pnpm clean         # Clean build artifacts and node_modules

License

MIT

Contact & Support

For questions, issues, or feedback, please open an issue on GitHub or reach out to the team.

---

Built with ❤️ for the Solana ecosystem