We use UV to manage dependencies so we highly recommend installing it as it will automatically provision a Python environment with the expected Python version.

After installing UV, you'll just have to run this command:

uv sync

Most of the SDK is generated code. Modifications to code will be persisted between generations, but may result in merge conflicts between manual patches and changes from the generator. The generator will never modify the contents of the src/llama_stack_client/lib/ and examples/ directories.

If you’d like to use the repository from source, you can either install from git or link to a cloned repository:

To install via git:

uv pip install git+ssh://git@github.com/stainless-sdks/llama-stack-python.git

Alternatively, you can build from source and install the wheel file:

Building this package will create two files in the dist/ directory, a .tar.gz containing the source files and a .whl that can be used to install the package efficiently.

To create a distributable version of the library, all you have to do is run this command:

uv build

Then to install:

uv pip install ./path-to-wheel-file.whl

Most tests require you to set up a mock server against the OpenAPI spec to run the tests.

# you will need npm installed
npx prism mock path/to/your/openapi.yml

uv run pytest

There is a pre-commit hook that will run ruff and black on the code.

To run the pre-commit hook:

uv run pre-commit

Changes made to this repository via the automated release PR pipeline should publish to PyPI automatically. If the changes aren't made through the automated pipeline, you may want to make releases manually.

You can release to package managers by using the Publish PyPI GitHub action. This requires a setup organization or repository secret to be set up.

If you need to manually release a package, you can run the bin/publish-pypi script with a PYPI_TOKEN set on the environment.