Metadata-Version: 2.1
Name: bleu-js
Version: 1.5.42
Summary: Advanced AI and Quantum Computing Framework
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.18.5) ; 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 (>=46.0.5,<50.0.0) ; extra == "server" or extra == "all" or extra == "ci"
Requires-Dist: fastapi (>=0.116.1,<0.140.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: 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.0,<5.0.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.26.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.12) ; 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 (>=78.1.1,<84.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.51) ; 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.51.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.

**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) |
| **Repos** | This SDK + [bleujs.org](https://github.com/HelloblueAI/bleujs.org) — [map](docs/REPOSITORIES.md) |

---

## 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) |
| Benchmarks | [ACHIEVEMENTS.md](docs/ACHIEVEMENTS.md) · [PERFORMANCE.md](docs/PERFORMANCE.md) |
| Change the API (both repos) | [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]
```

Production **chat / generate / embed** are served by **[bleujs.org](https://bleujs.org)**. Details: [Who serves the API](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).

