predictions

Machina Predictions Templates

Collection of AI-powered soccer prediction templates for the Machina platform.

📋 Table of Contents

• Overview
• Complete Pipeline Flow
• Quick Start (Zero to Results)
• Performance Benchmarks
• Templates
  • Soccer Power Ranking
  • Soccer Predictions Analyst
• Prerequisites
• Architecture
• Installation Order
• Common Workflows
  • Initial Setup
  • Backtesting Historical Season
  • Consolidating Results
• Document Types
• Supported Leagues
• Important Notes
• Monitoring Progress
• Common Issues
• Pipeline Verification Checklist
• Standards

---

Overview

This repository contains agent templates for soccer analytics and predictions:

• ⚽ Soccer Power Ranking - Team ranking system based on match performance
• 🎯 Soccer Predictions Analyst - Match prediction and forecasting
• 📊 Soccer Kalshi Analyst - Kalshi market analysis and betting

Important: These templates depend on the API Football system, which is installed from a separate repository. The API Football agents (api-football-populate, api-football-event-consumer-live, etc.) must be available in your Machina environment.

Verify API Football Installation

# Check if API Football populate agent is available
try:
    agent = mcp_machina-client-dev_get_agent_by_name(name="api-football-populate")
    print(f"✅ API Football is installed - Agent ID: {agent['data']['data']['_id']}")
except:
    print("❌ API Football not found - Install from the API Football repository first")

---

Configuração de Leagues

O sistema suporta múltiplas leagues e temporadas. A configuração é gerenciada pelo agente soccer-power-ranking-setup.

Leagues Configuradas (Dev)

Após executar o setup inicial, as seguintes leagues estarão disponíveis:

League ID	Nome	Temporada	Status
39	EPL	2025	✅ Ativo
71	Brasileirão	2024	✅ Ativo
71	Brasileirão	2025	✅ Ativo

Adicionar Nova League/Temporada

Passo 1: Edite a configuração:

# Edit: agent-templates/soccer-power-ranking/configs/setup-leagues.yml
# Add new league entry in the leagues array

Passo 2: Reimporte o template:

mcp_machina-client-dev_get_local_template(
    template="agent-templates/soccer-power-ranking",
    project_path="/app/machina-predictions-templates/agent-templates/soccer-power-ranking"
)

Passo 3: Reexecute o setup:

setup = mcp_machina-client-dev_get_agent_by_name(name="soccer-power-ranking-setup")
mcp_machina-client-dev_execute_agent(
    agent_id=setup['data']['data']['_id'],
    context={"environment": "dev"},
    messages=[{"role": "user", "content": "Update configuration"}]
)

Verificar configuração:

config = mcp_machina-client-dev_search_documents(
    filters={"name": "api-football-leagues-config"},
    page_size=1
)
print(config['data']['data'][0]['value']['leagues'])

---

Complete Pipeline Flow