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.
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 |
| Repos | This SDK + bleujs.org — map |
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 |
| Benchmarks | ACHIEVEMENTS.md · PERFORMANCE.md |
| Change the API (both repos) | 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]
Production chat / generate / embed are served by bleujs.org. Details: Who serves the API · 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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file bleu_js-1.5.42.tar.gz.
File metadata
- Download URL: bleu_js-1.5.42.tar.gz
- Upload date:
- Size: 39.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b70fb26f08f6568ca1e970939852e6694a85832c17cf3c446f32e7ce99e66e1f
|
|
| MD5 |
ed37010bd181d00588e55a535b1ddf75
|
|
| BLAKE2b-256 |
58a8143721ea5bacfa82e08fede9a368a3dcf8b8da433d3ddae351b211e3e2f7
|
File details
Details for the file bleu_js-1.5.42-py3-none-any.whl.
File metadata
- Download URL: bleu_js-1.5.42-py3-none-any.whl
- Upload date:
- Size: 44.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d1dfdf43142e68cc99ea8899dcf239b8b3e4061fb22da92b7b306944f8cfd288
|
|
| MD5 |
ea9a98d1b25cd06df9d20b93fe6e9ce1
|
|
| BLAKE2b-256 |
9f2d11ec50cc114f5a420aac624145a980051fb00892edfb131d5c36a41cbb35
|
