Metadata-Version: 2.4
Name: lightblue-ai
Version: 0.3.4
Summary: Light Blue is a lightweight agent designed for coding.
Project-URL: Repository, https://github.com/ai-zerolab/lightblue-ai
Author-email: Wh1isper <jizhongsheng957@gmail.com>
License-File: LICENSE
Keywords: python
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: anthropic>=0.49.0
Requires-Dist: anyio>=4.9.0
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: pdf2image>=1.17.0
Requires-Dist: pillow!=11.2.0,>=11.1.0
Requires-Dist: pluggy>=1.5.0
Requires-Dist: pydantic-ai>=0.0.55
Requires-Dist: pydantic-settings>=2.8.1
Requires-Dist: pydantic>=2.11.1
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 agent designed for generating HTML.

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

## Pre-requisites

### 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`

## Usage

### CLI

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

- `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.
