saymrwulf/alpha-arena
1
0
Fork 0
mirror of https://github.com/saymrwulf/alpha-arena.git synced 2026-09-04 18:43:39 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
alpha-arena/docs/index.md
oho 774f8b3f61 Initial commit: Alpha Arena - Polymarket Autonomous Trading Harness 
A comprehensive autonomous trading system for Polymarket prediction markets
featuring multi-LLM provider support, a native macOS menu bar app, and a
web-based control dashboard.

Key features:
- Multi-agent trading system (Research, Risk, Execution, Reflection agents)
- LLM provider flexibility (Anthropic, OpenAI, Google, xAI, Local models)
- Automatic provider fallback chain for resilience
- Native Swift/SwiftUI macOS menu bar application
- FastAPI web dashboard with real-time WebSocket updates
- Risk management with kill switch
- Technical indicators and market analysis
2026-01-12 23:04:58 +01:00

2.8 KiB
Raw Blame History

Alpha Arena Documentation

Welcome to Alpha Arena. This guide helps you find the right documentation for your needs.

Quick Navigation

Just want to run it?

../QUICKSTART.md - Daily commands, start/stop, basic troubleshooting

Using the web interface?

WEB_APP_MANUAL.md - Complete web UI guide with screenshots and workflows

Need the full reference?

USER_MANUAL.md - CLI commands, multi-agent system, strategies, API reference

Running in production?

OPERATIONAL_MANUAL.md - Deployment, monitoring, backup, security

Writing or running tests?

TESTING.md - Test structure, fixtures, writing tests

Documentation Overview

Document Audience Content
QUICKSTART.md Everyone 5-minute guide, daily commands
WEB_APP_MANUAL.md Operators Web interface, dashboards, controls
USER_MANUAL.md Developers Full CLI, agents, strategies, API
OPERATIONAL_MANUAL.md DevOps Deployment, monitoring, security
TESTING.md Developers Test suite, fixtures, patterns

Learning Path

Beginner

  1. Read ../QUICKSTART.md - Get running
  2. Explore WEB_APP_MANUAL.md - Use the web UI
  3. Try simulation mode before live trading

Intermediate

  1. Study USER_MANUAL.md Sections 6-10 - Agents, strategies, risk
  2. Learn technical indicators (Section 11)
  3. Understand memory system (Section 14)

Advanced

  1. Review OPERATIONAL_MANUAL.md - Production deployment
  2. Customize strategies via config
  3. Integrate with other systems via API

Quick Reference

Start the System

./alpha start        # Start server
./alpha open         # Open web UI

Stop the System

./alpha stop         # Graceful shutdown

Check Status

./alpha status       # Is it running?
./alpha logs         # What's happening?

Run Tests

./alpha test         # All tests
./scripts/test.sh    # More options

Key Concepts

Concept What it means
Multi-Agent Four AI agents (Research, Risk, Execution, Reflection) collaborate
Kelly Criterion Mathematical formula for optimal position sizing
Kill Switch Emergency stop all trading
Simulation Mode Paper trading, no real money
Edge Your expected advantage over market price

Getting Help

  1. Check the troubleshooting section in ../QUICKSTART.md
  2. Review logs: ./alpha logs
  3. Run diagnostics: ./scripts/check.sh
  4. Search the relevant manual for your issue