Bleu.js
Open-source SDK, CLI, and API contract, with an optional self-hosted app. bleujs.org — Get your first API call in under two minutes.
pip install bleu-js installs the Python SDK and CLI. They call the public hosted API at https://api.bleujs.org. Machine learning, quantum computing, and deep learning are optional extras ([ml], [quantum], [deep]), not the default install. [server] runs the optional self-hosted app.
Bleu OS was removed from this project. Older PyPI release pages that describe Bleu OS, including “the world’s first OS” and speed claims, are historical.
| Who it's for | ML engineers, researchers, and developers building cloud APIs or CLI tools |
| Status | Beta — Changelog · Roadmap |
| Security | No secrets in repo — SECURITY.md |
| API | Hosted API at https://api.bleujs.org — contract |
Get started in 60 seconds
1. Install (Python 3.11, 3.12, or 3.13):
pip install bleu-js
2. Get an API key at bleujs.org, then set it:
export BLEUJS_API_KEY="bleujs_sk_your_key_here"
# or: bleu config set api-key bleujs_sk_your_key_here
3. Run:
bleu chat "Say hello in one word."
Or in Python:
from bleujs.api_client import BleuAPIClient
print(BleuAPIClient().chat([{"role": "user", "content": "Say hello."}]).content)
4. Verify (optional): bleu version or bleujs version · bleu health or bleujs health
Walkthrough: Get started · Quickstart · API Client Guide
For developers (clone & contribute)
git clone https://github.com/HelloblueAI/Bleu.js.git && cd Bleu.js
python -m venv .venv && source .venv/bin/activate # Windows: .venv\Scripts\activate
# Python 3.11, 3.12, or 3.13
pip install -e .
cp .env.example .env # set BLEUJS_API_KEY
bleu chat "Hello"
| Need | Install |
|---|---|
| SDK + CLI (daily dev) | pip install -e . |
| Tests / CI parity | pip install -e ".[ci]" |
| Self-host FastAPI app | pip install -e ".[server]" |
| Full ML + quantum + server | pip install -e ".[all]" |
Setup: Contributing → Development setup · Install from source
Optional extras
| Extra | Install | Use case |
|---|---|---|
| Default | pip install bleu-js |
API client + CLI |
| ML | pip install "bleu-js[ml]" |
XGBoost, scikit-learn |
| Quantum | pip install "bleu-js[quantum]" |
Qiskit, PennyLane |
| Deep | pip install "bleu-js[deep]" |
PyTorch, TensorFlow |
| Server | pip install -e ".[server]" |
Self-host product app |
| Full | pip install "bleu-js[all]" |
Everything |
Self-host: copy .env.example → .env, then python main.py. See INSTALLATION.md and SECURITY.md.
SDK & CLI (quick reference)
Hosted API: https://api.bleujs.org — get a key at bleujs.org.
from bleujs.api_client import BleuAPIClient
client = BleuAPIClient() # reads BLEUJS_API_KEY
print(client.chat([{"role": "user", "content": "What is quantum computing?"}]).content)
print(client.generate("Write a haiku about AI:").text)
print(client.embed(["text1", "text2"]).embeddings)
export BLEUJS_API_KEY=bleujs_sk_...
bleu chat "Explain quantum computing"
bleu generate "Once upon a time" --max-tokens 500
bleu embed "hello" "world"
bleu models list
bleu health
Both bleu and bleujs command names work. Full CLI/SDK docs: API Client Guide · Examples
Documentation map
| I want to… | Start here |
|---|---|
| Install or upgrade | INSTALLATION.md |
| Which package to install | PACKAGE_MAP.md |
| First API call | GET_STARTED.md |
| SDK, CLI, API contract | API_CLIENT_GUIDE.md |
| API reference | API_REFERENCE.md |
| Architecture & features | PRODUCT_ARCHITECTURE.md · Platform overview |
| Quantum / ML examples | examples/ · Quantum teleportation |
| Older published claims | ACHIEVEMENTS.md · PERFORMANCE.md — not current benchmarks |
| Change the API | CHANGING_THE_API.md |
| Contribute | CONTRIBUTING.md · Contributor guide |
| Security & deployment | SECURITY.md · DEPLOYMENT_PRACTICES.md |
| FAQ | USER_CONCERNS_AND_FAQ.md |
| Evaluation / awards | EVALUATION_AND_AWARDS.md |
Architecture (at a glance)
flowchart LR
A["pip install bleu-js"] --> B{Use case?}
B -->|Cloud API & CLI| C[API key → bleu chat / SDK]
B -->|Quantum| D["bleu-js[quantum]"]
B -->|ML| E["bleu-js[ml]"]
C --> F[api.bleujs.org]
The SDK and CLI call the hosted API at https://api.bleujs.org. Contract: openapi.yaml · API client notes · Product philosophy.
Contributing
We welcome contributions — good first issues, docs, and tests.
Contributing guide · Maintainers · Code of Conduct · Discussions
Support: support@helloblue.ai · Security: security@helloblue.ai (use SECURITY.md, not public issues)
License
Bleu.js is licensed under the MIT License. Maintained by Helloblue Inc. — see MAINTAINERS.md.
1 maintainer
Metadata
1 maintainer
Release files for bleu-js 1.5.178
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| bleu_js-1.5.178.tar.gz | 40.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bleu_js-1.5.178-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 85.6 kB
Release files / bleu_js-1.5.178.tar.gz
| Download URL | bleu_js-1.5.178.tar.gz |
|---|---|
| Size | 40.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2a0f996eee26b41f3f68e81d5b7006c5ecde4717dccdf3ef85e59f7753374cb2
|
|
BLAKE2b-256 checksum How to use checksums |
b2c208e6c6687163c9e60b1fe518cee668d6b19d2438307b1bbb6fb7e56a010e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
Release files / bleu_js-1.5.178-py3-none-any.whl
| Download URL | bleu_js-1.5.178-py3-none-any.whl |
|---|---|
| Size | 45.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f7412a45031d2cd908eba0e0da6373059824990d21a0bb18b467cb84341cd671
|
|
BLAKE2b-256 checksum How to use checksums |
e90d42247914244077f6c4f967c6701edd192c87b5303ecaf31d3c080a5a9d7c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
