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.

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.

🎯 Current Features (v1.0.1)

Feature	Status	Description	Setup Guide
AI Market Analysis	✅ Released	Paste a Kalshi or Polymarket URL and get instant AI-powered analysis with probability estimates, confidence scores, and trading recommendations	📖 Setup Guide
Betting Bots	✅ Released	Polymarket 15 Minute Up/Down Arbitrage Bot (more bots coming)	📖 Setup Guide

🔮 Coming Soon

Feature	Description
Agent Battles (x402)	Pit AI agents against each other to discover winning strategies
No Code Builder	Build trading strategies without writing code
Whale Tracking	Monitor and follow large traders across markets
Copytrading	Automatically copy top-performing traders
Arbitrage Opportunity	Detect and exploit cross-platform price differences
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

PredictOS/
├── terminal/                        # Frontend (Next.js 14)
│   ├── src/
│   │   ├── app/                     # Next.js App Router
│   │   ├── components/              # React components
│   │   └── types/                   # TypeScript definitions
│   └── public/                      # Static assets
│
└── supabase/                        # Backend (Supabase)
    ├── migrations/                  # DB migrations (future features)
    └── functions/
        ├── _shared/                 # Shared utilities
        │   ├── ai/                  # AI integrations (xAI Grok & OpenAI)
        │   └── dome/                # Dome API client
        ├── analyze-event-markets/   # Market analysis endpoint
        └── <feature-name>/          # Future edge functions

💡 Extensibility: New features are added as Edge Functions under supabase/functions/<feature-name>/ with shared logic in _shared/. Database schemas live in supabase/migrations/.

🏁 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:

• Market Analysis: docs/features/market-analysis.md — requires DOME_API_KEY + AI provider key (XAI_API_KEY or OPENAI_API_KEY)
• Betting Bots: docs/features/betting-bots.md — requires POLYMARKET_WALLET_PRIVATE_KEY + POLYMARKET_PROXY_WALLET_ADDRESS

Example for Market Analysis:

DOME_API_KEY=your_dome_api_key      # Get from https://dashboard.domeapi.io

# AI Provider (only one is required)
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

Example for Betting Bots:

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`:
SUPABASE_EDGE_FUNCTION_ANALYZE_EVENT_MARKETS=http://127.0.0.1:54321/functions/v1/analyze-event-markets  # Required for Market Analysis
SUPABASE_EDGE_FUNCTION_BETTING_BOT=http://127.0.0.1:54321/functions/v1/polymarket-up-down-15-markets    # Required for Betting Bots

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
• Dome API — Unified prediction market data
• xAI Grok — xAI's reasoning models (Grok 4, Grok 4.1)
• OpenAI GPT — OpenAI's language models (GPT-4.1, GPT-5)

🤝 Partners

	Dome API The unified API for prediction markets. Dome provides seamless access to Kalshi, Polymarket, and other prediction market platforms through a single, elegant interface. 🔗 PredictOS is proudly powered by Dome — they handle the complexity of multi-platform data aggregation so we can focus on building the best trading tools. 🌐 Website · 📊 Dashboard · 𝕏 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

💪 Contributing

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

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. 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}