Skip to content

Latest commit

 

History

History
68 lines (43 loc) · 3.93 KB

File metadata and controls

68 lines (43 loc) · 3.93 KB

CI Docs PyPI npm

FLOX

FLOX is an AI-native framework for building trading systems.

Strategies, backtests, paper trading, and live execution sit behind one toolkit. AI agents discover the surface and drive it end-to-end through an MCP control plane. One strategy class runs backtest, paper, and live. Bindings for Python, Node.js, Codon, embedded JavaScript, and a stable C API.

Documentation is available at flox-foundation.github.io/flox

Language bindings

Language Install Docs
Python pip install flox-py reference
Node.js npm install @flox-foundation/flox reference
Codon build from source reference
JavaScript (embedded) bundled with C++ build reference
C API libflox_capi.so reference

All bindings expose the same strategy API, indicators, order books, backtesting, and data I/O. The C API is the integration point for adding support for any other language.

AI companion

flox-mcp is a Model Context Protocol server that gives AI coding agents (Cursor, Claude Code, Cline) grounded access to the FLOX surface — symbol lookups across bindings, scaffolders, indicator and backtest tools, full-text doc search.

pip install flox-mcp

See the package README for setup and the full tool list.

Connectors

Native exchange connectors (Bybit, Bitget, Hyperliquid, Polymarket) live under connectors/ and build with -DFLOX_BUILD_CONNECTORS=ON. The flag defaults to OFF so a backtest-only or research build doesn't pay the dependency cost. See the connectors README for adapter notes and the optional Polymarket Rust toolchain step.

Venue

Beyond trading on a market, FLOX can be one: the optional venue/ module adds a matching engine and the machinery around it, so many participants can trade against a single order book. See the venue docs.

Build options

The CMake options that gate every optional artefact (bindings, demo, tools, tests, benchmarks, connectors) are catalogued in docs/build/feature-flags.md. Defaults are OFF so a bare cmake -B build produces only the core C++ static library.

Commercial Services

For commercial support, enterprise connectors, and custom development, visit floxlabs.dev.

Contributing

Contributions are welcome via pull requests. Please follow the existing structure and naming conventions. Tests, benchmarks, and documentation should be included where appropriate. Code style is enforced via clang-format. See contributing guide.

License

FLOX is licensed under the MIT License. See LICENSE for details.

Disclaimer

FLOX is provided "as is" without warranty of any kind, express or implied. The authors are not liable for any damages or financial harm arising from its use, including trading losses or system failures. This software is intended for educational and research purposes. Production use is at your own risk. See DISCLAIMER.md for full legal notice.