flybrain_sdk
Community / Open source

Build with us.
No GPU needed.

Fork the repository, make a focused change and open a pull request. Contributions are reviewed before merging, and pull requests run automated tests.

Useful first contributions

  • Add a versioned model URL with size, license, attribution and checksum.
  • Build a small MaleCNS/FlyWire subgraph importer with tests and a model card.
  • Extend the Godot adapter or add Unity and other environments.
  • Port the LIF reference core to WASM and compare traces with Python.
  • Improve examples, translations and error messages.

The contribution loop

  1. Open an issue for a substantial design change, or pick an existing issue.
  2. Fork, branch and install the Python development dependencies.
  3. Make the change and add meaningful tests or examples.
  4. Run tests and the quickstart, then open a pull request.
Validation
python -m pip install -e ".[dev]"
pytest
python examples/quickstart.py
ruff check .
ruff format --check .

Do not commit bulk datasets, tokens or private information. Identify data licenses and distinguish raw data from runnable models. No CUDA hardware is required to contribute to the Python core.

Open an issue Contribution guide

What is next?

Real-data subgraphs come first, then measured CPU performance, game integrations and a tested WASM implementation. The TypeScript CPU runtime now powers the circuit lab and exported demos. NPM publication, CUDA, WASM and game-engine adapters remain future work.