Metadata-Version: 2.1
Name: brainframe-cli
Version: 0.2.2
Summary: Makes installing and managing a BrainFrame server easy
Home-page: https://github.com/aotuai/brainframe_cli
License: BSD-3-Clause
Author: Aotu.ai
Author-email: info@aotu.ai
Requires-Python: >=3.6.9,<4.0.0
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: distro (>=1.5,<2.0)
Requires-Dist: docker (>4.3.1,<7.0.0)
Requires-Dist: docker-compose (>=1.29.2,<2.0.0)
Requires-Dist: packaging (>=20.4,<21.0)
Requires-Dist: python-i18n (>=0.3,<0.4)
Requires-Dist: pyyaml (>=3.10,<6)
Requires-Dist: requests (>=2.24.0,<3.0.0)
Requires-Dist: websocket-client (>=0.32.0,<1.0)
Project-URL: Repository, https://github.com/aotuai/brainframe_cli
Description-Content-Type: text/x-rst

==============
BrainFrame CLI
==============

The BrainFrame CLI is a tool for installing and managing a BrainFrame server.

Installation
------------

The CLI is installable with Pip. Ubuntu 18.04 and 20.04 are officially
supported, but other versions of Linux are expected to work as well.

On Ubuntu:

.. code-block::

    sudo -H pip3 install brainframe-cli

Upgrading
---------

Pip can be used to upgrade to a new version.

.. code-block::

    sudo -H pip3 install --upgrade brainframe-cli

Usage
-----

To install BrainFrame, simply run the ``install`` command as root:

.. code-block::

    sudo brainframe install

BrainFrame can then be controlled like a normal Docker Compose application
using the ``compose`` command, which can be run from any directory.

.. code-block::

    brainframe compose up -d

For more information, take a look at the `Getting Started guide`_.

.. _`Getting Started guide`: https://aotu.ai/docs/getting_started/

Contributing
------------

We happily take community contributions! If there's something you'd like to
work on, but you're not sure how to start, feel free to create an issue on
Github and we'll try to point you in the right direction.

We use a couple formatting tools to keep our code style consistent. If you get
any CI failures, you can run the following commands to automatically format
your code to fit our guidelines:

.. code-block:: bash

    pip install poetry==1.8.3
    poetry install
    poetry run isort .
    poetry run black .

Build & install local build for test:

.. code-block:: bash

    python3 deployment/build.py --version 3.8
    python3 deployment/build.py --version 3.10 3.12
    pip install dist/brainframe_cli-0.3.0-py3-none-any.whl

The above build.py will copy pyproject.toml & poetry.lock in deployment folder
to the project root, and automatically run poetry build. Similar to below,

.. code-block:: bash

    poetry build
    pip install dist/brainframe_cli-0.3.0-py3-none-any.whl

The wheel build & test commands have been integrated in deployment/do script,
which support build & test on Ubuntu 18.04/20.04/22.04/24.04

.. code-block:: bash

    deployment/do

Pyinstaller build:

The result will be in the dist/ directory

.. code-block:: bash

    pyinstaller package/main.spec


