Skip to main content

llm-hubris

PyPI Changelog Tests License

LLM plugin for models hosted by Hubris — an OpenAI-compatible LLM gateway billed in Russian rubles, with 400+ models (OpenAI, Anthropic, Google, DeepSeek, Qwen and more) behind a single API key.

Installation

First, install the LLM command-line utility.

Now install this plugin in the same environment as LLM.

llm install llm-hubris

Configuration

You will need an API key from Hubris. Create one at hubris.pw/keys.

You can set that as an environment variable called HUBRIS_API_KEY, or add it to the llm set of saved keys using:

llm keys set hubris
Enter key: <paste key here>

Usage

The plugin registers every chat model from your Hubris catalog. To list them, run:

llm models list

You should see a list that looks something like this:

Hubris: hubris/anthropic/claude-sonnet-5
Hubris: hubris/openai/gpt-5.6-luna
Hubris: hubris/google/gemini-3.7-flash
Hubris: hubris/deepseek/deepseek-v4-flash-0731
...

Model IDs always use the full vendor/model form shown in the Hubris catalog — there is no alias resolution on the gateway side.

The list is cached for an hour. Force a refresh with:

llm hubris refresh

To run a prompt against a model, pass its full model ID to the -m option:

llm -m hubris/anthropic/claude-sonnet-5 "Five spooky names for a pet tarantula"

You can set a shorter alias for a model using the llm aliases command:

llm aliases set sonnet hubris/anthropic/claude-sonnet-5

Now you can prompt it with:

cat llm_hubris.py | llm -m sonnet -s 'write some pytest tests for this'

Images are supported by vision models:

llm -m hubris/anthropic/claude-sonnet-5 'describe this image' -a https://static.simonwillison.net/static/2024/pelicans.jpg

Reasoning models accept the reasoning_effort option:

llm -m hubris/openai/gpt-5.6-luna -o reasoning_effort high 'Plan a three-day trip to Kazan'

Listing models with prices

llm hubris models

Outputs every chat model with its context window and RUB prices per million tokens. Add --json for the raw catalog entries.

Development

To set up this plugin locally, first checkout the code. Then create a new virtual environment:

cd llm-hubris
python -m venv venv
source venv/bin/activate

Now install the dependencies and test dependencies:

pip install -e '.[test]'

To run the tests:

pytest

Download files

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

Source Distribution

llm_hubris-0.1.0.tar.gz (6.6 kB view details)

Uploaded Source

Built Distribution

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

llm_hubris-0.1.0-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

File details

Details for the file llm_hubris-0.1.0.tar.gz.

File metadata

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

File hashes

Hashes for llm_hubris-0.1.0.tar.gz
Algorithm Hash digest
SHA256 a2252baa71eff66266bdaecf681ada490c5b8341cb34e2f57b9eaa74d8e61d57
MD5 1c1e7c57558dd7d0c3a8039a6f9c5e6c
BLAKE2b-256 97845562deb4f006a0b691d27d2917bf76a4f8770907292bae18b412a7989e17

See more details on using hashes here.

Provenance

The following attestation bundles were made for llm_hubris-0.1.0.tar.gz:

Publisher: publish.yml on Aimagine-life/llm-hubris

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

File details

Details for the file llm_hubris-0.1.0-py3-none-any.whl.

File metadata

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

File hashes

Hashes for llm_hubris-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ff2e40030cda4f5a19bf529796a1a024401b74f354e3f7daa29108768e4c95bc
MD5 c930dbf149af58def241cad5c391079c
BLAKE2b-256 ce369ed7581896a3a85503a4dc8cb69adff8a41073279fd52182fa7c05147a02

See more details on using hashes here.

Provenance

The following attestation bundles were made for llm_hubris-0.1.0-py3-none-any.whl:

Publisher: publish.yml on Aimagine-life/llm-hubris

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.1.1

2 files

This release

0.1.0 This release

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