Masterbrain Python Package

Published Python package for the Masterbrain monorepo. It owns the provider-neutral AI core, model provider adapters, FastAPI service, desktop launcher, Python tests, and PyInstaller packaging flow.

The package depends on the sibling airalogy package in source checkouts and uses it to validate and unpack .aira archives for the local protocol/record library.

For platform coverage and packaging limits, see ../../PLATFORM_SUPPORT.md. For PyPI release automation, see ../../RELEASING.md. For usage metering and Platform billing integration, see ../../docs/en/usage-and-billing.md.

Setup

cp .env.example .env
uv sync --dev

packages/masterbrain/.env is the standard location for local runtime configuration.

Run

Start the FastAPI server:

uv run uvicorn masterbrain.fastapi.main:app --reload --host 127.0.0.1 --port 8080

Launch the integrated desktop-style local app after building the frontend in apps/studio:

uv run masterbrain-studio

masterbrain-desktop is kept as a deprecated compatibility alias and will be removed in a future release.

You can bind the app to an existing workspace directory:

uv run masterbrain-studio --workspace /path/to/project

You can also pass an .aira archive path as the launch document. Masterbrain will import it into the local library before opening the UI:

uv run masterbrain-studio /path/to/archive.aira

OpenCode

Code-edit flows require an OpenCode runtime. Either install opencode globally, or vendor it locally:

python3 scripts/vendor_opencode.py

Tests

Run the Python package test suite:

uv run python -m pytest

pytest.ini excludes openai and qwen markers by default.

Packaging

PyPI publishing is handled by the repository-level GitHub Actions release workflow on v* tag pushes.

Build the packaged local bundle with the cross-platform CLI:

uv run masterbrain-build-desktop

Wrapper scripts are also available:

  • macOS / Linux: ./scripts/build_desktop_bundle.sh
  • Windows PowerShell: .\scripts\build_desktop_bundle.ps1

This builds the frontend from apps/studio, vendors OpenCode into packages/masterbrain/vendor/, syncs the packaging dependency group, writes the raw PyInstaller bundle to packages/masterbrain/dist/Masterbrain/, and then packages platform release artifacts under packages/masterbrain/dist/release/<platform>/.

  • macOS: unsigned Masterbrain.app and a versioned .zip
  • Windows x64: portable directory, portable .zip, and an Inno Setup .iss script; if ISCC.exe is available or passed via --inno-setup-compiler, the installer .exe is also built
  • Linux: portable directory and a versioned .tar.gz

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for seekr from gravatar.com seekr Avatar for yangzijie from gravatar.com yangzijie

Credits

Author: Airalogy MasterBrain Team

License

Apache License 2.0

Requires

Python >=3.13

Provides Extra

all-providers api litellm openai qwen

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

masterbrain-0.11.0.tar.gz (117.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

masterbrain-0.11.0-py3-none-any.whl (192.8 kB view details)

Uploaded Python 3

File details

Details for the file masterbrain-0.11.0.tar.gz.

File metadata

  • Download URL: masterbrain-0.11.0.tar.gz
  • Upload date:
  • Size: 117.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for masterbrain-0.11.0.tar.gz
Algorithm Hash digest
SHA256 11a5f315ffcbe6ad3c7f844bad48a59c330066ec31dc733267f8525a0e4a624e
MD5 891db5b914d9021ac24ba96ba2fcc272
BLAKE2b-256 559274ac7550639c68d05ad599168176b7b7045b73878fb295e4d29fc2ba3237

See more details on using hashes here.

Provenance

The following attestation bundles were made for masterbrain-0.11.0.tar.gz:

Publisher: release.yml on airalogy/masterbrain

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file masterbrain-0.11.0-py3-none-any.whl.

File metadata

  • Download URL: masterbrain-0.11.0-py3-none-any.whl
  • Upload date:
  • Size: 192.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for masterbrain-0.11.0-py3-none-any.whl
Algorithm Hash digest
SHA256 990a455331c9da8a68eb1231d7fc983bbf4a7bb772b1a9a5e0825ce2db56e524
MD5 e1b54233c049d413901232c385cc53ae
BLAKE2b-256 6dc66304fde4652a1832c0c8c0f473e8730fbe2c3c30303906ada0f100dfad46

See more details on using hashes here.

Provenance

The following attestation bundles were made for masterbrain-0.11.0-py3-none-any.whl:

Publisher: release.yml on airalogy/masterbrain

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.11.0 This release

2 files

0.10.1

2 files

0.10.0

2 files

0.9.1

2 files

0.9.0

2 files

0.8.0

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page