Active development. Mentat is under active development. APIs, schemas, and on-chain layouts may change between releases. Production use at your own risk. Issues and PRs welcome.
AI-native prediction markets on Solana, resolved by zkTLS proofs and bootstrapped with curator-verified agent workflows.
- Website: https://mentat.cryptuon.com/
- Documentation: https://docs.cryptuon.com/mentat/
- Source: https://github.com/cryptuon/mentat
- Permissionless creation: AI assistants draft market questions, resolution criteria, and liquidity terms so anyone can launch high-quality markets with minimal friction.
- Cryptographic settlement: zkTLS proofs bridge real-world data into Solana smart contracts, replacing trusted arbiters with verifiable outcomes.
- Fanatical usability: A Polymarket-inspired UX couples rapid deployment with transparent discovery, proof timelines, and curator guardrails.
Mentat is past its Creator MVP (M2) and on-chain launch (M3) milestones. The codebase contains:
- AI-Powered Market Creation — generate markets from ideas in approximately 15 seconds via the Scout / Draft / Validator agent pipeline
- Human Curation Workflow — bulk actions, diff view, version history
- Full-Stack Implementation — Vue 3 frontend, FastAPI backend, PostgreSQL
- Authentication — JWT with wallet and email/password support
- Solana Programs —
market-factoryandmarket-settlementAnchor programs with generated IDLs - Event Indexer — TypeScript indexer with PostgreSQL storage and a WebSocket feed
- Wallet Integration — Phantom and Solflare support, transaction signing, balance queries
- Trading Interface — trading panel, position cards, and trade confirmation modals wired to the on-chain programs
Up next: zkTLS oracle integration, automated settlement, and a hardening pass ahead of a production launch.
See docs/M2-COMPLETION-SUMMARY.md and
PROJECT-STATUS.md for milestone detail.
cd apps/backend
uv sync
make upgrade # apply database migrations
make dev # runs on http://localhost:8000cd apps/web
npm install
npm run dev # runs on http://localhost:5173cd apps/ai-agents
uv sync
export OPENAI_API_KEY="your-key" # or ANTHROPIC_API_KEY
uv run python examples/quickstart.pyFor more detail, see QUICK-START.md and the per-app
READMEs under apps/.
┌─────────────┐
│ Web Frontend│ Vue 3 + Pinia + TypeScript
│ │ - Creator Studio (AI-powered)
│ │ - Curator Console (bulk operations)
│ │ - Discovery Hub
└──────┬──────┘
│ HTTP (JWT)
┌──────▼──────┐
│ Backend API │ FastAPI + TortoiseORM + PostgreSQL
│ │ - Authentication (wallet/email)
│ │ - Market CRUD
│ │ - Curation workflow
│ │ - AI generation endpoints
└──────┬──────┘
│ Python
┌──────▼──────┐
│ AI Agents │ DSPy + OpenAI/Anthropic
│ │ - Scout Agent (source research)
│ │ - Draft Agent (market generation)
│ │ - Validator Agent (quality checks)
└─────────────┘
- AI-Assisted Creation: Describe your market idea, AI generates the full specification
- Real-Time Progress: Watch Scout, Draft, and Validator agents work
- Validation Scores: See quality, safety, and clarity scores before submission
- Iterative Refinement: Request AI improvements based on curator feedback
- Bulk Operations: Claim, approve, or reject multiple drafts at once
- Diff View: Side-by-side comparison of draft versions
- Version History: Track complete revision history
- Validation Dashboard: Quality scores and issues at a glance
- Audit Trail: Complete history of all curation actions
The published documentation site is at
docs.cryptuon.com/mentat. The raw
source for that site lives in documentation/; a
larger archive of design notes and milestone reports lives in
docs/.
- M2 Completion Summary - Complete milestone overview
- Creator Studio Enhancement - AI-powered market creation
- Curator Console Enhancement - Bulk actions and diff view
- AI Agents Summary - Scout, Draft, Validator agents
- Integration Guide - Web-backend integration
- Product Overview - Vision and user journeys
- AI Architecture - AI agent design
- System Integration - Component integration
- Market Standard - Market specification format
- Solana Market Schema - On-chain program design
- Fee Model - Platform economics
- Tokenomics - Token design
-
✅ M1 - Research & Design (Complete)
- Market standard definition
- AI architecture design
- System integration plan
-
✅ M2 - Creator MVP (Complete)
- Backend API with authentication
- AI agents (Scout, Draft, Validator)
- Creator Studio with AI generation
- Curator Console with bulk operations
- Web-backend integration
-
✅ M3 - On-Chain Launch (Complete)
- Solana programs (
market-factory,market-settlement) - Event indexer with WebSocket feed
- Wallet integration (Phantom, Solflare)
- Trading interface
- Solana programs (
-
🚧 M4 - zkTLS Integration (In Progress)
- zkTLS oracle implementation
- Automated settlement
- Resolution verification
-
📋 M5 - Production Launch (Planned)
- Security audit
- Performance optimization
- Mobile app
- Onboarding and growth
| Layer | Technology |
|---|---|
| Frontend | Vue 3, Pinia, TypeScript, Vite |
| Backend | FastAPI, TortoiseORM, PostgreSQL, Aerich |
| AI | DSPy, OpenAI GPT-4, Anthropic Claude |
| Blockchain | Solana, Anchor |
| Indexer | Node.js, TypeScript, PostgreSQL, WebSocket |
| Wallets | Phantom, Solflare |
| Auth | JWT, bcrypt |
| Verification | zkTLS (planned, M4) |
mentat/
├── apps/
│ ├── backend/ # FastAPI backend + Aerich migrations
│ ├── web/ # Vue 3 frontend
│ ├── ai-agents/ # DSPy AI agents (Scout, Draft, Validator)
│ ├── indexer/ # Node.js/TypeScript Solana event indexer
│ ├── proof-service/ # zkTLS proof submission service
│ └── solana-programs/ # Anchor programs (market-factory, market-settlement)
├── documentation/ # MkDocs source for docs.cryptuon.com/mentat
├── docs/ # Design notes, milestone reports, deep-dives
└── README.md # This file
- Fork the repository
- Create a feature branch (
git checkout -b feature/your-feature) - Make your changes and test
- Commit with clear messages (
git commit -m 'Add feature') - Push to your branch (
git push origin feature/your-feature) - Open a Pull Request
See component READMEs for specific development guidelines:
- Documentation: docs.cryptuon.com/mentat
- Website: mentat.cryptuon.com
- Issues: GitHub Issues
- Discussions: GitHub Discussions
Mentat is released under the Apache-2.0 license. See LICENSE if
present in the repository.
Current Milestone: M3 - On-Chain Launch (complete) Next Milestone: M4 - zkTLS Integration