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:
Newer release available (0.11.0)

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.10.1.tar.gz (115.7 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.10.1-py3-none-any.whl (190.9 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for masterbrain-0.10.1.tar.gz
Algorithm Hash digest
SHA256 5e1116aa650de3073744ca84fd6efcd8eb3d2c0a8a7be35d210da30ee6f07715
MD5 547071c7d339ffd2007dee56a4221a3e
BLAKE2b-256 35de45c797426834dd22a124111b58acd1c4581da71c23b04ac3a0e33ed4b09c

See more details on using hashes here.

Provenance

The following attestation bundles were made for masterbrain-0.10.1.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.10.1-py3-none-any.whl.

File metadata

  • Download URL: masterbrain-0.10.1-py3-none-any.whl
  • Upload date:
  • Size: 190.9 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.10.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e16f0d0fd4fd8c550a14f15138cc65db64be080eba6dc343f772ecf36731bd2b
MD5 fc0a47cc9a9b14a66fba8d98fbde71fe
BLAKE2b-256 3aacdda6b01e4ad8ff3fc2eb954c819663ab668d71ae9615697ccb4d675bfc99

See more details on using hashes here.

Provenance

The following attestation bundles were made for masterbrain-0.10.1-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

0.11.0

2 files

This release

0.10.1 This release

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