Bleu.js
Quantum-enhanced AI platform: cloud API, CLI, and Python SDK. bleujs.org — Get your first API call in under two minutes.
Bleu.js combines classical machine learning with optional quantum computing.
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.
Efficient by default, powerful by choice. pip install bleu-js ships the API client + CLI only (no torch/shap/numba). Add [ml], [quantum], [deep], or [all] when you need heavier stacks.
| 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+):
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
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.177
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.177.tar.gz | 39.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bleu_js-1.5.177-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 84.2 kB
Release files / bleu_js-1.5.177.tar.gz
| Download URL | bleu_js-1.5.177.tar.gz |
|---|---|
| Size | 39.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c9a4fa507c9af7724e2dd8822ca37ea8601787dfa785b416b4a2dbcb361fadff
|
|
BLAKE2b-256 checksum How to use checksums |
4206d69944abe8cffa611d29fbe49f75aeca0b3f510f2aabfcdfbec41e85d406
|
| 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.177-py3-none-any.whl
| Download URL | bleu_js-1.5.177-py3-none-any.whl |
|---|---|
| Size | 44.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
af16cb17947690323831db96ac4661848cff73dfa43372294434fab203ea2e24
|
|
BLAKE2b-256 checksum How to use checksums |
82283fd9b9686919c74f7ee147486736d72338af2cc38ccc9b0b874baa8e36ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.3
|
