PredictOS

The leading all-in-one open-source framework for deploying custom AI agents and trading bots purpose-built for prediction markets - bring your own data, models, and strategies to dominate prediction forecasting

Built by PredictionXBT, the team behind Predict — The Layer 1 for Social Prediction Market

🌐 Social Prediction Markets · 𝕏 PredictionXBT · 🖥️ Alpha/Arb Terminal · 🤖 Predict Agent

✨ What is PredictOS?

Prediction markets are having their moment. With platforms like Kalshi and Polymarket opening up their APIs to the public, there's now unprecedented access to real-time market data, order books, and trading capabilities. But raw API access is just the beginning — what's been missing is a unified framework that lets anyone tap into this new financial primitive.

💡 Jupiter Support: We also support Jupiter prediction markets since they're built on Kalshi events — just paste a Jupiter URL and PredictOS will analyze the underlying Kalshi market.

PredictOS is that framework.

🔓 Why Open Source?

Sure, there are hosted tools out there. But here's the problem:

Your data isn't yours. Every query, every strategy signal, every trade you analyze — it all flows through their servers. Your alpha becomes their alpha. Your edge gets commoditized the moment you share it with a third party.
Your strategy isn't private. Want to build a custom trading bot with proprietary signals? Maybe you've got insider domain knowledge, a unique data source, or a thesis nobody else is running. The moment you plug that into a hosted platform, you've handed over your playbook.
You can't customize what you don't own. Need a specific feature? Want to integrate your own AI model? Good luck submitting a feature request and waiting 6 months.

With PredictOS, you own everything. Run it on your own infrastructure. Fork it. Modify it. Build your secret sauce without anyone watching. Your strategies stay yours. Your data never leaves your servers. And when you find an edge, you keep it.

PredictOS is an open-source, AI-powered operating system for prediction markets. It provides a unified interface to analyze markets across platforms, delivering real-time AI insights to help you find alpha opportunities and make informed trading decisions.

Whether you're a casual trader looking for quick market analysis or a power user building automated betting strategies with proprietary data, PredictOS gives you the tools to navigate prediction markets — on your own terms.

What's next? We're building towards a complete prediction market toolkit: automated betting bots, whale tracking, copytrading, cross-platform arbitrage, and more. See the Coming Soon section for the full roadmap.

💎 The $PREDICT Token

$PREDICT serves as the foundational pillar of the open-source PredictOS framework, powering a decentralized, community-driven Layer 1 ecosystem for social prediction markets, trading, and participation.

As the primary utility token, $PREDICT is deeply integrated across the platform:

Launchpad Liquidity — The launchpad will be seeded with $PREDICT liquidity to ensure depth, stability, and fair access for new project discoveries and token launches
No-Code Builder Access — Essential for accessing upcoming no-code builder tools that allow anyone to effortlessly create custom prediction markets, agents, or interfaces with premium features unlocked through holding or using $PREDICT
Ecosystem Engagement — Required for full participation in the broader Predict ecosystem, including creating markets, accessing advanced analytics, AI-driven signals, and governance

🔥 Staking & Rewards

A key feature driving adoption is the ability to stake $PREDICT for attractive APY rewards, delivering passive yields while empowering holders with enhanced capabilities:

Unlocked Trading Abilities — Enhanced access to trading features and boosted capabilities
Prediction Market Access — Boosted access to the native prediction market for betting on events, outcomes, or price movements
Long-Term Value — Staking and liquidity provision promotes long-term holding, strengthens network security, and redistributes value directly to the community

💡 $PREDICT is more than a token — it's the core fuel powering adoption, liquidity, and innovation in the live PredictOS framework, establishing it as a leader in decentralized social prediction markets.

🧠 Introducing Predict Super Intelligence: PredictOS V2 Release

Predict Super Intelligence represents the next evolution of PredictOS — a powerful multi-agent AI system that enables intelligent, team-like analysis and execution across prediction markets.

The Vision

Traditional market analysis tools give you a single perspective. Predict Super Intelligence breaks this paradigm by custom-bulding multiple AI agents and making them work together, each bringing unique capabilities, tools, and models to form a comprehensive market view.

How It Works

Predict Super Intelligence operates through a sophisticated agent pipeline:

Predict Agents — Deploy one or more AI agents (using xAI Grok or OpenAI GPT models -- Gemini coming in future releases) to independently analyze prediction markets. Each agent can be equipped with different tools (X Search, Web Search, Polyfactual Research) and custom commands to focus their analysis.
Predict Bookmaker Agent — When multiple agents complete their analysis, the Bookmaker Agent acts as a "judge" that synthesizes all perspectives, weighs agreements and disagreements, and produces a consolidated recommendation with consensus metrics.
Mapper Agent — Translates analysis outputs into platform-specific order parameters ready for execution.

Two Modes of Operation

Mode	Description	Use Case
🔍 Supervised	Agents analyze the market and provide recommendations. User reviews the analysis and can execute via OkBet one-click links.	Research, learning, manual trading
⚡ Autonomous	Agents analyze the market and automatically execute trades based on recommendations (within your budget limits). Currently, single Polymarket market is supported. Batch market + Kalshi coming soon.	Automated trading, hands-off execution

Key Features

Multi-Model Support — Mix and match xAI Grok (4.1, 4) and OpenAI GPT (5.2, 5.1, 4.1) models
Tool-Augmented Analysis — Agents can use X (Twitter) search, Web search, Polyfactual deep research, and x402/PayAI sellers
Custom Commands — Direct agent focus with natural language instructions
Real-Time Pipeline Visualization — Watch agents work through the analysis pipeline
Consensus Metrics — See how agents agree or disagree on recommendations
Budget Controls — Set strict limits for autonomous execution ($1-$100)
🛡️ Verifiable Agents — Permanently store agent analysis on Irys blockchain for transparent, verifiable AI predictions

📖 Full Setup Guide →

🎯 Current Features (v2.4.0)

Feature	Status	Description	Setup Guide
🌐 Supported Markets	✅ Released	Kalshi, Polymarket, and Jupiter (Kalshi-based). Data powered by DFlow (Kalshi/Jupiter) and Dome (Polymarket).	—
🧠 Super Intelligence	✅ Released	Multi-agent AI system with Supervised and Autonomous modes. Deploy multiple AI agents with different models and tools, aggregate insights via Bookmaker Agent, and execute trades automatically or via OkBet. Includes AI-powered market analysis and Polyfactual Deep Research.	📖 Setup Guide
⚖️ Arbitrage Intelligence	✅ Released	AI-powered cross-platform arbitrage detection between Polymarket and Kalshi. Paste any market URL, and the system automatically searches for the same market on the other platform, compares prices, and provides actionable arbitrage strategies with profit calculations.	📖 Setup Guide
🛡️ Verifiable Agents	✅ Released	Permanently store agent analysis on Irys blockchain for transparent, verifiable AI predictions. Supports both devnet (free, temporary) and mainnet (permanent).	📖 Setup Guide
💸 x402 / PayAI Integration	✅ Released	Access paid AI services and data providers through the x402 protocol. Browse the PayAI bazaar, select sellers, and pay with USDC on Solana or Base. Use as a tool in your Predict Agents.	📖 Setup Guide
Betting Bots	✅ Released	Polymarket 15 Minute Up/Down Arbitrage Bot — Vanilla Mode (single price straddle) and Ladder Mode (multi-level tapered allocation for maximized fill rates)	📖 Setup Guide
Wallet Tracking	✅ Released	Real-time order tracking for any Polymarket wallets using Dome SDK WebSockets — 10 seconds faster than hosted bots	📖 Setup Guide

🔮 Coming Soon

Feature	Description
Agent Battles	Pit AI agents against each other to discover winning strategies
No Code Builder	Build trading strategies without writing code
Whale Tracking	Automated alerts and analysis for large traders across markets
Copytrading	Automatically copy top-performing traders
Perps Trading / Leverage	Leveraged prediction market positions
$Predict Staking	Stake for APY rewards, unlock enhanced trading abilities, and get boosted access to prediction markets
Predict Protocol SDK	For trading Social markets built on Predict (currently Testnet on predictionxbt.fun)

📦 Architecture

Data Providers

PredictOS uses specialized data providers for each prediction market platform:

Platform	Data Provider	API Endpoint	Features
Kalshi	🔷 DFlow	`a.prediction-markets-api.dflow.net`	Event data, market prices, volume, liquidity, open interest
Polymarket	🌐 Dome	`api.domeapi.io`	Market data, CLOB tokens, WebSocket feeds, order execution

💡 Note: DFlow API requires an API key. Contact DFlow to obtain your DFLOW_API_KEY.

Project Structure

PredictOS/
├── terminal/                        # Frontend (Next.js 14)
│   ├── src/
│   │   ├── app/                     # Next.js App Router
│   │   │   ├── api/                 # API routes (proxy to Edge Functions)
│   │   │   │   ├── arbitrage-finder/   # Arbitrage Intelligence proxy
│   │   │   │   ├── bookmaker-agent/
│   │   │   │   ├── event-analysis-agent/
│   │   │   │   ├── get-events/
│   │   │   │   ├── irys-upload/        # Verifiable Agents - Irys blockchain upload
│   │   │   │   ├── mapper-agent/
│   │   │   │   ├── polyfactual-research/
│   │   │   │   ├── polymarket-put-order/
│   │   │   │   ├── wallet-tracking/
│   │   │   │   └── x402-seller/         # x402/PayAI integration
│   │   │   ├── arbitrage/           # Arbitrage Intelligence UI
│   │   │   ├── market-analysis/     # Super Intelligence UI
│   │   │   ├── betting-bots/        # Betting Bots UI
│   │   │   └── wallet-tracking/     # Wallet Tracking UI
│   │   ├── components/              # React components
│   │   │   ├── AgenticMarketAnalysis.tsx   # Super Intelligence component
│   │   │   ├── ArbitrageTerminal.tsx       # Arbitrage Intelligence component
│   │   │   ├── BettingBotTerminal.tsx
│   │   │   └── WalletTrackingTerminal.tsx
│   │   ├── lib/                     # Utility libraries
│   │   │   ├── irys.ts              # Irys blockchain integration
│   │   │   └── utils.ts
│   │   └── types/                   # TypeScript definitions
│   └── public/                      # Static assets
│
└── supabase/                        # Backend (Supabase Edge Functions)
    └── functions/
        ├── _shared/                 # Shared utilities
        │   ├── ai/                  # AI integrations (xAI Grok & OpenAI)
        │   │   ├── callGrok.ts
        │   │   ├── callOpenAI.ts
        │   │   └── prompts/         # Agent prompts
        │   │       ├── arbitrageAnalysis.ts      # Arbitrage comparison prompt
        │   │       └── searchQueryGenerator.ts   # Cross-platform search prompt
        │   ├── dflow/               # DFlow API client (Kalshi data)
        │   │   ├── client.ts
        │   │   ├── endpoints.ts
        │   │   └── types.ts
        │   ├── dome/                # Dome API client (Polymarket data)
        │   │   ├── client.ts
        │   │   ├── endpoints.ts
        │   │   └── types.ts
        │   ├── polyfactual/         # Polyfactual Research client
        │   ├── polymarket/          # Polymarket trading client
        │   └── x402/                # x402/PayAI protocol client
        │       ├── client.ts        # Bazaar discovery & payment handling
        │       └── types.ts
        ├── arbitrage-finder/        # Arbitrage Intelligence endpoint
        ├── get-events/              # Fetch market data from URL
        ├── event-analysis-agent/    # Individual agent analysis
        ├── bookmaker-agent/         # Multi-agent aggregator
        ├── mapper-agent/            # Analysis-to-order translator
        ├── polymarket-put-order/    # Order execution
        ├── polyfactual-research/    # Deep research endpoint
        ├── x402-seller/             # x402/PayAI bazaar & seller calls
        └── polymarket-up-down-.../  # Betting bot endpoint

💡 Extensibility: New agents and features are added as Edge Functions under supabase/functions/<feature-name>/ with shared logic in _shared/. The modular architecture allows mixing different AI providers, tools, and execution strategies.

🏁 Getting Started

Prerequisites

Node.js v18+
Supabase CLI v1.0+
Docker (for local Supabase)

1. Clone the Repository

git clone https://github.com/PredictionXBT/PredictOS.git
cd PredictOS

2. Start the Backend (Supabase)

# Navigate to supabase directory
cd supabase

# Copy environment template and add your API keys
cp .env.example .env.local

Edit .env.local with the credentials required for the features you want to use:

📖 Feature-specific setup guides:

Super Intelligence: docs/features/super-intelligence.md — requires DOME_API_KEY (Polymarket) + DFLOW_API_KEY (Kalshi) + AI provider keys (XAI_API_KEY and/or OPENAI_API_KEY). Optional: POLYFACTUAL_API_KEY for Polyfactual tool. For Autonomous mode: POLYMARKET_WALLET_PRIVATE_KEY + POLYMARKET_PROXY_WALLET_ADDRESS.

Betting Bots: docs/features/betting-bots.md — requires POLYMARKET_WALLET_PRIVATE_KEY + POLYMARKET_PROXY_WALLET_ADDRESS

Wallet Tracking: docs/features/wallet-tracking.md — requires DOME_API_KEY (frontend only, no Supabase needed)

Example for Super Intelligence (full setup):

# Market Data Providers
DOME_API_KEY=your_dome_api_key              # Get from https://dashboard.domeapi.io (for Polymarket)
DFLOW_API_KEY=your_dflow_api_key            # Contact DFlow: https://x.com/dflow (for Kalshi)

# AI Providers (configure one or both)
XAI_API_KEY=your_xai_api_key                # Get from https://x.ai
OPENAI_API_KEY=your_openai_api_key          # Get from https://platform.openai.com

# Polyfactual Tool (optional, enables Polyfactual research tool)
POLYFACTUAL_API_KEY=your_polyfactual_key    # Contact Polyfactual to obtain

# Autonomous Mode (optional, for auto-execution on Polymarket)
POLYMARKET_WALLET_PRIVATE_KEY=0x...         # Your wallet private key
POLYMARKET_PROXY_WALLET_ADDRESS=0x...       # Your Polymarket proxy wallet

💡 Note: See the setup guides linked above for detailed instructions on obtaining each API key and configuration.

Start the Supabase services:

supabase start

Once running, get your local credentials (you'll need these for the frontend):

supabase status

This will display your API URL and anon key — save these for the next step.

Now start the Edge Functions server (keep this running):

supabase functions serve --env-file .env.local

3. Start the Frontend (Terminal)

Open a new terminal:

# Navigate to terminal directory
cd terminal

# Install dependencies
npm install

# Copy environment template
cp .env.example .env

Edit .env with credentials from supabase status:

SUPABASE_URL=<API URL from supabase status>
SUPABASE_ANON_KEY=<anon key from supabase status>

# Edge Function URLs (for local development)
# Note that the base url might vary depending on `supabase status`:

# Super Intelligence endpoints
SUPABASE_EDGE_FUNCTION_GET_EVENTS=http://127.0.0.1:54321/functions/v1/get-events
SUPABASE_EDGE_FUNCTION_EVENT_ANALYSIS_AGENT=http://127.0.0.1:54321/functions/v1/event-analysis-agent
SUPABASE_EDGE_FUNCTION_BOOKMAKER_AGENT=http://127.0.0.1:54321/functions/v1/bookmaker-agent
SUPABASE_EDGE_FUNCTION_MAPPER_AGENT=http://127.0.0.1:54321/functions/v1/mapper-agent
SUPABASE_EDGE_FUNCTION_POLYMARKET_PUT_ORDER=http://127.0.0.1:54321/functions/v1/polymarket-put-order
SUPABASE_EDGE_FUNCTION_POLYFACTUAL_RESEARCH=http://127.0.0.1:54321/functions/v1/polyfactual-research

# Betting Bots endpoint
SUPABASE_EDGE_FUNCTION_BETTING_BOT=http://127.0.0.1:54321/functions/v1/polymarket-up-down-15-markets

Start the development server:

npm run dev

Your PredictOS terminal will be running at http://localhost:3000

🛠️ Tech Stack

Frontend:

Next.js 14 — React framework with App Router
React 18 — UI library
TailwindCSS — Utility-first CSS
Lucide React — Icon library

Backend:

Supabase Edge Functions — Serverless Deno runtime
DFlow API — Kalshi prediction market data
Dome API — Polymarket data & trading
xAI Grok — xAI's reasoning models (Grok 4, Grok 4.1)
OpenAI GPT — OpenAI's language models (GPT-4.1, GPT-5)
Irys — Permanent blockchain storage for Verifiable Agents
x402 / PayAI — HTTP 402 payment protocol for paid AI services

🤝 Partners and Collaborators

	Privy Wallet infrastructure for winning teams. Recently acquired by Stripe, Privy powers 100M+ accounts and processes billions in volume every year with low-level APIs for onchain payments and asset management. 🔗 PredictOS partners with Privy to supercharge wallet infrastructure across the Predict ecosystem — delivering more secure, seamless, and unified wallet integrations to make it easier than ever to onboard users with any wallet. 🌐 Website · 𝕏 Twitter
	DFlow High-precision, low-latency Solana DEX aggregator. DFlow delivers the most advanced trading infrastructure on Solana, unlocking cutting-edge financial markets for applications. Their Prediction Markets API provides a seamless, programmatic gateway to tokenized Kalshi event contracts — offering deep liquidity, broad coverage, and full onchain composability. 🔗 PredictOS integrates DFlow's Prediction Markets API to bring tokenized Kalshi markets directly to Solana builders, empowering agentic workflows and multi-agent collaborations powered by real-world predictive intelligence. 🌐 Website · 𝕏 Twitter
	Dome API The unified API for prediction markets. Dome provides seamless access to Polymarket through an elegant interface with WebSocket support for real-time data. 🔗 PredictOS uses Dome for Polymarket market data, order execution, and real-time wallet tracking via WebSocket feeds. 🌐 Website · 📊 Dashboard · 𝕏 Twitter
	PayAI (x402) The HTTP 402 payment protocol for AI agents. PayAI enables seamless machine-to-machine payments using the x402 protocol, allowing AI agents to pay for API calls and services automatically with USDC on Solana or Base. 🔗 PredictOS integrates PayAI to power the x402 Tool in Super Intelligence — enabling agents to discover and call paid AI services from the PayAI bazaar with automatic payment handling. Browse sellers, select services, and let your agents pay for premium data and analysis. 🌐 Website · 📖 Docs · 𝕏 Twitter
	IRYS The high-performance datachain unifying storage and native smart contract execution. 🔗 PredictOS integrates IRYS to power Verifiable Agents — permanently storing all agent analysis, recommendations, and execution results on the blockchain for transparent, auditable AI predictions. This creates an immutable record of agent decisions that anyone can verify. 🌐 Website · 📖 Docs · 𝕏 Twitter
	OKBet The FIRST all-in-one prediction markets bot. Available on Telegram and soon on web, OKBet makes it easy to trade prediction markets from anywhere. 🔗 Our Predict_Agent provides direct OKBet links to place bets on Kalshi and Polymarket in Telegram. 🤖 Telegram · 🌐 Website · 📖 Docs · 𝕏 Twitter
	Polyfactual Deep AI research & API layer for prediction markets. Polyfactual also provides Weekly Polymarket livestreams on news + ecosystem developments. 🔗 PredictOS integrates Polyfactual's Deep Research API to power the Polyfactual tool in Super Intelligence — enabling agents to get comprehensive answers with citations. 🌐 Website · 𝕏 Twitter
	Hey Anon Building AI tools for investors, traders, developers, and institutions — DeFAI. Hey Anon is launching Pandora, a fully permissionless prediction market where users can create their own markets and earn fees. 🔗 PredictOS is partnering with Hey Anon to integrate Pandora and bring Alpha Terminal insights to permissionless markets — together we're building the future of decentralized prediction markets. 🌐 Website · 𝕏 Twitter

💪 Contributing

We welcome contributions from the community! Here's how you can help:

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

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

🔗 Links

Website: predictionxbt.fun
Twitter/X: @prediction_xbt
GitHub: PredictionXBT/PredictOS

Star History

Built with ❤️ by the PredictionXBT team

_{Powered by Dome (Polymarket) & DFlow (Kalshi)}

Name		Name	Last commit message	Last commit date
Latest commit History 91 Commits
.vscode		.vscode
docs/features		docs/features
supabase		supabase
terminal		terminal
.cursorignore		.cursorignore
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json

License

devatnull/PredictOS

Folders and files

Latest commit

History

Repository files navigation