lightblue-ai

Inspired by Deep Blue – Harnessing computational power to transcend human design.

The Bitter Lesson

The Bitter Lesson: Rethinking How We Build AI Systems

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:

uvx lightblue-ai stream <prompt>

Use prompt file:

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

Submit

Directly prompt:

uvx lightblue-ai submit <prompt>

Use prompt file:

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

Programmatic

See agent.py and Examples

Configuration

• prompt.md use this file as the user prompt
• system_prompt.md to Override system prompt
• mcp.json to configure MCP
• .env for setting environment variables

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:

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.