Metadata-Version: 2.4
Name: lightblue-ai
Version: 0.5.2
Summary: Light Blue is an agentic agent framework for building AI applications
Project-URL: Repository, https://github.com/ai-zerolab/lightblue-ai
Author-email: Wh1isper <jizhongsheng957@gmail.com>
License-File: LICENSE
Keywords: agent,agentic,llm
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: <4.0,>=3.10
Requires-Dist: httpx>=0.28.1
Requires-Dist: jinja2>=3.1.6
Requires-Dist: loguru>=0.7.3
Requires-Dist: lxml>=5.3.2
Requires-Dist: markitdown[all]>=0.1.1
Requires-Dist: mcp>=1.6.0
Requires-Dist: openai>=1.74.0
Requires-Dist: pdf2image>=1.17.0
Requires-Dist: pillow!=11.2.0,>=11.1.0
Requires-Dist: playwright>=1.51.0
Requires-Dist: pluggy>=1.5.0
Requires-Dist: pydantic-ai>=0.1.8
Requires-Dist: pydantic-settings>=2.8.1
Requires-Dist: pydantic>=2.11.1
Requires-Dist: pymupdf4llm>=0.0.21
Requires-Dist: python-dotenv>=1.1.0
Requires-Dist: rich>=14.0.0
Requires-Dist: tavily-python>=0.5.3
Requires-Dist: typer>=0.15.2
Requires-Dist: typing-extensions>=4.13.0
Description-Content-Type: text/markdown

# lightblue-ai

[![Release](https://img.shields.io/github/v/release/ai-zerolab/lightblue-ai)](https://img.shields.io/github/v/release/ai-zerolab/lightblue-ai)
[![Build status](https://img.shields.io/github/actions/workflow/status/ai-zerolab/lightblue-ai/main.yml?branch=main)](https://github.com/ai-zerolab/lightblue-ai/actions/workflows/main.yml?query=branch%3Amain)
[![codecov](https://codecov.io/gh/ai-zerolab/lightblue-ai/branch/main/graph/badge.svg)](https://codecov.io/gh/ai-zerolab/lightblue-ai)
[![Commit activity](https://img.shields.io/github/commit-activity/m/ai-zerolab/lightblue-ai)](https://img.shields.io/github/commit-activity/m/ai-zerolab/lightblue-ai)
[![License](https://img.shields.io/github/license/ai-zerolab/lightblue-ai)](https://img.shields.io/github/license/ai-zerolab/lightblue-ai)

> Inspired by Deep Blue – Harnessing computational power to transcend human design.
>
> [The Bitter Lesson](http://www.incompleteideas.net/IncIdeas/BitterLesson.html)
>
> [The Bitter Lesson: Rethinking How We Build AI Systems](https://ankitmaloo.com/bitter-lesson/)

Light Blue is an agentic agent framework for building AI applications.

- **Github repository**: <https://github.com/ai-zerolab/lightblue-ai/>

## Usage

### CLI

#### Stream

Directly prompt:

```bash
uvx lightblue-ai stream <prompt>
```

Use prompt file:

```bash
uvx lightblue-ai stream prompt.md # Or just uvx lightblue-ai stream, prompt.md is the default prompt file
```

#### Submit

Directly prompt:

```bash
uvx lightblue-ai submit <prompt>
```

Use prompt file:

```bash
uvx lightblue-ai submit prompt.md # Or just uvx lightblue-ai submit, prompt.md is the default prompt file
```

### Programmatic

See [agent.py](./lightblue_ai/agent.py) and [Examples](./examples/README.md)

## Configuration

- `prompt.md` use this file as the user prompt
- `system_prompt.md` to Override [system prompt](./lightblue_ai/prompts/templates/system_prompt.md)
- `mcp.json` to configure [MCP](./mcp.example.json)
- `.env` for [setting environment variables](./.env.example)

Once you provided the api-key of the tools, tools will automatically be loaded.

## Tools

### PDF to Image

You need to install poppler for pdf to image conversion

#### Mac

Mac users will have to install poppler for pdf to image conversion

Installing using Brew:

```bash
brew install poppler
```

#### Linux

Most distros ship with pdftoppm and pdftocairo. If they are not installed, refer to your package manager to install poppler-utils. e.g. `apt-get install poppler-utils`

### HTML View as Image

you need to run `playwright install` or `uv tool run playwright install` to install chromium and dependencies.
