Hermes Codex

The open-source AI agent platform.

Build, deploy, and manage autonomous AI agents — all from your browser.
Multi-model chat, code editor, terminal, tasks, cron, and more.

Try it now → · Tokenomics · Roadmap · Report Bug · 𝕏 @HSCodex

⭐ Star this repo if you find it useful — it helps a lot!

Why Hermes Codex?

Most AI tools are single-purpose. Hermes Codex gives you everything in one place:

Chat with 4 AI models (switch mid-conversation)
Build agents with custom prompts and memories
Write & run code in 8+ languages
Automate tasks — AI breaks goals into steps and executes them
Schedule cron jobs — recurring AI-powered workflows
Scrape the web — extract text, links, and summaries from any URL
100% serverless — runs on Cloudflare Pages (free tier works)

All data stored in Cloudflare D1 (SQLite at the edge). No external databases needed.

Screenshots

Chat with AI	Agent Builder	Code Editor

AI Terminal	Command Center	Settings

🎬 Full demo video: docs/videos/full-feature-test.mp4

Features

Feature	Description
🤖 Multi-Model Chat	Llama 3.3 70B, Llama 3.1 405B, DeepSeek R1, Qwen 2.5 — switch models mid-chat
🧩 Agent Builder	Create agents with custom names, system prompts, and model selection
💻 Code Editor	Write & run JS, Python, Ruby, Go, Rust, Java, C/C++, Bash
⌨️ AI Terminal	Real commands (`whoami`, `agents`, `tasks`) + AI-powered execution
📡 Command Center	14+ system commands with live stats from database
⚡ Autonomous Tasks	Describe a goal → AI breaks it into steps → auto-executes
🕐 Cron Jobs	Schedule recurring AI tasks (5 min to daily intervals)
🌐 Browser	Scrape URLs, extract text & links, AI summarization
📎 File Upload	Attach files in chat (max 5MB), AI acknowledges and helps
🔔 Notifications	Real-time alerts for task completion, uploads, and system events
📦 Data Export	Download all your data as JSON (agents, tasks, skills, chat history)
📊 Analytics	Usage dashboard — API calls, token usage, model breakdown charts
💰 Wallet	Track credits, transactions, and API key management
🔐 Auth	Google OAuth, GitHub OAuth, Email/Password + email verification
👤 Profiles	Editable profile with photo upload, display name, and bio
🔌 Plugins	Toggle platform extensions on/off per user
🔗 Base MCP	Connect AI agents to Base blockchain — send, swap, sign, contract calls via mcp.base.org

Quick Start

Option 1: Use the hosted version

→ hs-codex.com — free, no setup needed.

Option 2: Self-host on Cloudflare (free)

# 1. Clone
git clone https://github.com/hermesc0dex/hermes-codex.git
cd hermes-codex

# 2. Install dependencies
npm install

# 3. Create D1 database
npx wrangler d1 create hermes-codex-db

# 4. Run schema
npx wrangler d1 execute hermes-codex-db --remote --file=schema.sql

# 5. Deploy
npx wrangler pages deploy public --project-name=hermes-codex

Option 3: Local development

npm install
npx wrangler pages dev public
# → http://localhost:8788

Tech Stack

Layer	Technology
Frontend	Vanilla HTML/CSS/JS · JetBrains Mono · Dark theme
Backend	Cloudflare Pages Functions (serverless, 0ms cold start)
Database	Cloudflare D1 (SQLite at the edge)
AI	Venice AI — Llama 3.3 70B, 405B, DeepSeek R1, Qwen 2.5
Auth	JWT + bcrypt · Google OAuth · GitHub OAuth
Email	Resend ([email protected])

Architecture

┌──────────────┐     ┌──────────────────┐     ┌─────────────┐
│   Browser    │────▶│  Cloudflare Pages │────▶│  Venice AI  │
│  (Frontend)  │◀────│   (Functions)     │◀────│  (4 models) │
└──────────────┘     └────────┬─────────┘     └─────────────┘
                              │
                     ┌────────▼─────────┐
                     │  Cloudflare D1   │
                     │  (12+ tables)    │
                     └──────────────────┘

Environment Variables

Set in Cloudflare Pages → Settings → Environment Variables:

Variable	Required	Description
`JWT_SECRET`	✅	Secret for signing auth tokens
`VENICE_API_KEY`	✅	Venice AI API key (get one)
`RESEND_API_KEY`	❌	For email verification (resend.com)
`GOOGLE_CLIENT_ID`	❌	Google OAuth
`GOOGLE_CLIENT_SECRET`	❌	Google OAuth
`GITHUB_CLIENT_ID`	❌	GitHub OAuth
`GITHUB_CLIENT_SECRET`	❌	GitHub OAuth

Project Structure

hermes-codex/
├── functions/              # Serverless API
│   ├── _middleware.js      # JWT auth + CORS
│   ├── auth/               # Login, register, OAuth, email verification
│   ├── api/                # All API endpoints
│   │   ├── chat.js         # AI chat (multi-model)
│   │   ├── agents/         # Agent CRUD + chat
│   │   ├── tasks.js        # Autonomous tasks
│   │   ├── skills/         # Skills CRUD + run
│   │   ├── terminal.js     # AI terminal
│   │   ├── command.js      # Command center
│   │   ├── upload.js       # File upload
│   │   ├── export.js       # Data export (JSON)
│   │   ├── notifications.js
│   │   ├── cron/           # Cron jobs
│   │   ├── browser/        # Web scraping
│   │   ├── wallet.js       # Credits & transactions
│   │   └── admin/          # Admin dashboard APIs
│   └── lib/auth.js         # JWT helpers
├── public/                 # Static frontend (20+ pages)
├── schema.sql              # D1 database schema
├── wrangler.toml           # Cloudflare config
└── package.json

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

Good first issues are labeled with good first issue.

$HSCODEX Token

Hermes Codex has its own utility token: $HSCODEX

Property	Value
Ticker	$HSCODEX
Contract	`0xDF0C5Aa9bDE5d9d8cBa4e6699Dd7aCb326F9Fba3`
Type	ERC-20

The token powers the ecosystem — premium features, agent marketplace, governance, staking rewards, and builder incentives.

📄 Full Tokenomics → · 🗺️ Token Roadmap →

Roadmap

Platform:

Dark/Light theme toggle
Agent marketplace (share/download agent configs)
Team collaboration & workspaces
Webhook integrations (Discord, Telegram, Slack)
Mobile PWA (installable app)
More AI models (OpenAI, Anthropic, Google)

Token ($HSCODEX):

DEX listing (Uniswap / BaseSwap)
CoinGecko & CoinMarketCap listing
Token-gated premium features
Staking rewards
Agent marketplace payments
Governance portal

📋 Full Roadmap →

Star History

License

Built with ☕ and AI by Hermescodex

Website · 𝕏 Twitter · Tokenomics · Issues