# Lumiwealth/lumibot

Backtestable AI trading agents and Python algorithmic trading strategies for stocks, options, crypto, futures, forex, SEC filings, FRED macro data, and real brokers.

Repository: https://github.com/Lumiwealth/lumibot
Canonical: https://ross.abutalabs.com/products/lumibot
Homepage: https://lumibot.lumiwealth.com
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: broker, alpaca, trading-bot, finance, algorithmic-trading, backtesting, quantitative-finance, forex, ai-agents, crypto-trading, fred, futures-trading, interactive-brokers, llm-agents, multi-agent, options-trading, python, sec-filings, stocks, technical-analysis
Last push: 2026-08-26T03:58:44+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 87, longevity 100
- inputs: {"age_days": 2183, "days_push": 7, "days_rel": 7, "gap_med": 0, "n_releases_24m": 96}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1987, forks 379 (observed 2026-08-28T04:06:02.783464+00:00)

## What it is
Lumibot is a Python framework for building, backtesting, and deploying algorithmic trading strategies and AI-agent trading teams across stocks, options, crypto, futures, and forex. It provides a unified strategy API with lifecycle methods, order/account management, historical data access, and broker integrations like Alpaca and Interactive Brokers for paper and live trading.

## Use cases
- backtest a python trading strategy on historical data
- build an ai trading agent that places orders with an llm
- run a trading bot on alpaca or interactive brokers
- trade options spreads and iron condors automatically
- backtest multi-agent trading teams with simulated orders
- connect a strategy to real brokers for live trading
- analyze sec filings and fred macro data in a strategy
- reuse the same strategy code for backtest and live deployment

## When to choose
- you want a python framework that unifies backtesting and live broker execution
- you need to build deterministic or llm-driven trading strategies across multiple asset classes
- you want multi-agent AI trading teams with memory, tools, and observability
- you prefer a high-level strategy API with lifecycle hooks over raw broker SDKs

## When to avoid
- you need a general-purpose backtesting library for non-financial data
- you require a visual no-code trading platform
- you need ultra-low-latency HFT execution
- you want a GPL-free license for proprietary closed-source distribution

## Facets
- artifact type: framework
- maturity: active
- function: agent-framework, machine-learning, sdk, developer-tools
- domain: fintech, artificial-intelligence, large-language-models
- platform: python, cross-platform, cli
- tags: algorithmic-trading, backtesting, trading-bot, quantitative-finance, stocks, options, crypto, futures, forex, brokers, alpaca, interactive-brokers, llm-agents, multi-agent, technical-analysis, sec-filings, fred, cryptocurrency, ai-agents, automation

## Member repositories
- Lumiwealth/lumibot (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:02.783464+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:02:59.646407+00:00, confidence not recorded.
  - readme: https://github.com/Lumiwealth/lumibot (fetched 2026-08-28T04:06:02.783464+00:00, sha 3717a68cfa6c)
  - homepage: https://lumibot.lumiwealth.com (fetched 2026-08-29T10:42:48.803145+00:00, sha e11f276c68bc)
  - site_page: https://lumibot.lumiwealth.com/agents_quickstart.html (fetched 2026-08-29T10:42:48.813054+00:00, sha 09b1ead57e24)
  - site_page: https://lumibot.lumiwealth.com/faq.html (fetched 2026-08-29T10:42:48.815566+00:00, sha 32a9024b9315)
  - site_page: https://lumibot.lumiwealth.com/botspot_mcp.html (fetched 2026-08-29T10:42:48.818560+00:00, sha 83ea592acb76)
  - site_page: https://lumibot.lumiwealth.com/cash_accounting.html (fetched 2026-08-29T10:42:48.820400+00:00, sha 7255c42fba44)
- Data as of 2026-08-30T08:39:29.467469+00:00.