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]

Loading

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.