Metadata-Version: 2.1
Name: bleu-js
Version: 1.5.177
Summary: Python API client and CLI for the Bleu.js API, with optional ML and quantum extras
Home-page: https://bleujs.org
License: MIT
Author: Bleujs Team
Author-email: support@helloblue.ai
Requires-Python: >=3.11,<3.14
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Quantum Computing
Provides-Extra: all
Provides-Extra: api
Provides-Extra: ci
Provides-Extra: deep
Provides-Extra: gpu
Provides-Extra: ml
Provides-Extra: quantum
Provides-Extra: server
Requires-Dist: aiofiles (>=24.1,<26.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: aiohttp (>=3.13.3,<4.0.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: alembic (==1.20.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: boto3 (>=1.24.0,<2.0.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: click (>=8.2.1,<9.0.0)
Requires-Dist: cryptography (>=50.0.0,<51.0.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: fastapi (>=0.116.1,<0.142.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: filelock (>=3.20.3) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: gputil (>=1.4.0,<2.0.0) ; extra == "gpu" or extra == "all"
Requires-Dist: h11 (==0.16.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: httpx (>=0.28.1,<0.29.0)
Requires-Dist: jinja2 (>=3.1.6,<4.0.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: keras (>=3.13.2) ; extra == "deep" or extra == "all" or extra == "ci"
Requires-Dist: msgpack (>=1.2.1,<2.0.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: numpy (>=2.2.6,<3.0.0)
Requires-Dist: opentelemetry-api (>=1.35.0,<2.0.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: opentelemetry-sdk (>=1.35.0,<2.0.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: optuna (>=4.4,<6.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: pandas (>=2,<4) ; extra == "ml" or extra == "all" or extra == "ci"
Requires-Dist: passlib (>=1.7.4,<2.0.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: pennylane (>=0.42.1,<0.46.0) ; extra == "quantum" or extra == "all" or extra == "ci"
Requires-Dist: pillow (>=12.1.1) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: prometheus-client (>=0.23.1,<0.27.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: psutil (>=7.0.0,<8.0.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: psycopg2-binary (==2.9.13) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: pyasn1 (>=0.6.2) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: pydantic-settings (>=2.10.1,<3.0.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: pydantic[email] (>=2.7.0,<3.0.0)
Requires-Dist: pyjwt (>=2.10.1,<3.0.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: python-dotenv (>=0.21,<1.3) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: python-multipart (>=0.0.27,<0.0.33) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: qiskit (>=2.1.1,<3.0.0) ; extra == "quantum" or extra == "all" or extra == "ci"
Requires-Dist: qiskit-aer (>=0.17.1,<0.18.0) ; extra == "quantum" or extra == "all" or extra == "ci"
Requires-Dist: qiskit-algorithms (>=0.3,<0.5) ; extra == "quantum" or extra == "all" or extra == "ci"
Requires-Dist: ray (>=2.9.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: redis (>=6.2,<9.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: requests (>=2.32.4,<3.0.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: scikit-learn (>=1.2.2,<2.0.0) ; extra == "ml" or extra == "all" or extra == "ci"
Requires-Dist: setuptools (>=83.0.0,<85.0.0)
Requires-Dist: shap (>=0.48,<0.52) ; extra == "deep" or extra == "all" or extra == "ci"
Requires-Dist: sparse (>=0.17,<0.20) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: sqlalchemy (==2.0.54) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: starlette (>=0.49.1) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: tensorflow (>=2.19.0,<3.0.0) ; extra == "deep" or extra == "all" or extra == "ci"
Requires-Dist: torch (>=2.8.0,<3.0.0) ; extra == "deep" or extra == "all" or extra == "ci"
Requires-Dist: urllib3 (>=2.6.3)
Requires-Dist: uvicorn (==0.53.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: werkzeug (>=3.1.6) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: wheel (>=0.46.3,<1.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: xgboost (>=3.0.2,<4.0.0) ; extra == "ml" or extra == "all" or extra == "ci"
Project-URL: Documentation, https://github.com/HelloblueAI/Bleu.js/blob/main/docs/GET_STARTED.md
Project-URL: Repository, https://github.com/HelloblueAI/Bleu.js
Description-Content-Type: text/markdown

# Bleu.js

**Quantum-enhanced AI platform: cloud API, CLI, and Python SDK.** [bleujs.org](https://bleujs.org) — *Get your first API call in under two minutes.*

[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-brightgreen.svg)](LICENSE)
[![Status: Beta](https://img.shields.io/badge/Status-Beta-yellow.svg)]()
[![CI/CD](https://img.shields.io/github/actions/workflow/status/HelloblueAI/Bleu.js/main.yml?logo=github-actions&label=CI)](https://github.com/HelloblueAI/Bleu.js/actions)

![Bleu.js Demo](https://github.com/HelloblueAI/Bleu.js/assets/81389644/ddfc34a4-a992-441c-9cf4-c5feeeb43568)

<div align="left">
  <a href="https://htmlpreview.github.io/?https://github.com/HelloblueAI/Bleu.js/blob/main/simple_animated_demo.html" target="_blank">
    <img src="https://img.shields.io/badge/Try%20Live%20Demo-blue?style=for-the-badge&logo=github" alt="Live Demo" />
  </a>
  <a href="https://htmlpreview.github.io/?https://github.com/HelloblueAI/Bleu.js/blob/main/api_playground.html" target="_blank">
    <img src="https://img.shields.io/badge/API%20Playground-green?style=for-the-badge&logo=github" alt="API Playground" />
  </a>
</div>

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](CHANGELOG.md) · [Roadmap](docs/ROADMAP.md) |
| **Security** | No secrets in repo — [SECURITY.md](SECURITY.md) |
| **API** | Hosted API at `https://api.bleujs.org` — [contract](docs/api/openapi.yaml) |

---

## Get started in 60 seconds

**1. Install** (Python 3.11+):

```bash
pip install bleu-js
```

**2. Get an API key** at [bleujs.org](https://bleujs.org), then set it:

```bash
export BLEUJS_API_KEY="bleujs_sk_your_key_here"
# or: bleu config set api-key bleujs_sk_your_key_here
```

**3. Run:**

```bash
bleu chat "Say hello in one word."
```

Or in Python:

```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](docs/GET_STARTED.md) · [Quickstart](docs/QUICKSTART.md) · [API Client Guide](docs/API_CLIENT_GUIDE.md)

---

## For developers (clone & contribute)

```bash
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](docs/CONTRIBUTING.md#-development-setup) · [Install from source](docs/INSTALLATION.md#using-pip-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.example) → `.env`, then `python main.py`. See [INSTALLATION.md](docs/INSTALLATION.md) and [SECURITY.md](SECURITY.md).

---

## SDK & CLI (quick reference)

Hosted API: `https://api.bleujs.org` — get a key at [bleujs.org](https://bleujs.org).

```python
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)
```

```bash
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](docs/API_CLIENT_GUIDE.md) · [Examples](examples/README.md)

---

## Documentation map

| I want to… | Start here |
|------------|------------|
| Install or upgrade | [INSTALLATION.md](docs/INSTALLATION.md) |
| Which package to install | [PACKAGE_MAP.md](docs/PACKAGE_MAP.md) |
| First API call | [GET_STARTED.md](docs/GET_STARTED.md) |
| SDK, CLI, API contract | [API_CLIENT_GUIDE.md](docs/API_CLIENT_GUIDE.md) |
| API reference | [API_REFERENCE.md](docs/API_REFERENCE.md) |
| Architecture & features | [PRODUCT_ARCHITECTURE.md](docs/PRODUCT_ARCHITECTURE.md) · [Platform overview](docs/PLATFORM_OVERVIEW.md) |
| Quantum / ML examples | [examples/](examples/) · [Quantum teleportation](docs/QUANTUM_TELEPORTATION.md) |
| Older published claims | [ACHIEVEMENTS.md](docs/ACHIEVEMENTS.md) · [PERFORMANCE.md](docs/PERFORMANCE.md) — not current benchmarks |
| Change the API | [CHANGING_THE_API.md](docs/CHANGING_THE_API.md) |
| Contribute | [CONTRIBUTING.md](docs/CONTRIBUTING.md) · [Contributor guide](docs/CONTRIBUTOR_GUIDE.md) |
| Security & deployment | [SECURITY.md](SECURITY.md) · [DEPLOYMENT_PRACTICES.md](docs/DEPLOYMENT_PRACTICES.md) |
| FAQ | [USER_CONCERNS_AND_FAQ.md](docs/USER_CONCERNS_AND_FAQ.md) |
| Evaluation / awards | [EVALUATION_AND_AWARDS.md](docs/EVALUATION_AND_AWARDS.md) |

---

## Architecture (at a glance)

```mermaid
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](docs/api/openapi.yaml) · [API client notes](docs/WHO_SERVES_THE_API.md) · [Product philosophy](docs/PRODUCT_PHILOSOPHY.md).

---

## Contributing

We welcome contributions — [good first issues](https://github.com/HelloblueAI/Bleu.js/issues?q=is%3Aopen+label%3A%22good+first+issue%22), docs, and tests.

[Contributing guide](docs/CONTRIBUTING.md) · [Maintainers](MAINTAINERS.md) · [Code of Conduct](CODE_OF_CONDUCT.md) · [Discussions](https://github.com/HelloblueAI/Bleu.js/discussions)

**Support:** support@helloblue.ai · **Security:** security@helloblue.ai (use [SECURITY.md](SECURITY.md), not public issues)

---

## License

Bleu.js is licensed under the [MIT License](LICENSE). Maintained by [Helloblue Inc.](https://helloblue.ai) — see [MAINTAINERS.md](MAINTAINERS.md).

