Metadata-Version: 2.4
Name: logosai-forge
Version: 0.2.6
Summary: AI Agent Generation Library — Agents Building Agents
Author: LogosAI Team
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: google-generativeai>=0.8.0
Requires-Dist: loguru>=0.7.0
Requires-Dist: aiohttp>=3.9.0

# logosai-forge

**FORGE: An AI Agent Code Builder** — agents that create, fix, and evolve other agents.

15 agentic AI agents collaborate to autonomously generate, improve, enhance, and self-evolve agent code.

## Installation

```bash
pip install logosai-forge
```

## Quick Start

```python
import asyncio
from logosai_forge import ForgeClient

async def main():
    forge = ForgeClient()

    # Generate a new agent
    result = await forge.create_agent(
        "Calculate BMI from weight and height",
        test_cases=[{
            "input": {"weight_kg": 70, "height_m": 1.75},
            "expected": {"bmi": 22.9, "category": "normal"}
        }]
    )
    print(result.code)

    # Fix a broken agent
    result = await forge.improve_agent(agent_code, {
        "error_type": "logic_error",
        "error_message": "Condition is inverted — score>700 should approve",
        "test_input": {"credit_score": 750},
        "expected_output": {"decision": "approved"},
        "actual_output": {"decision": "denied"},
    })
    print(result.changes)

    # Add missing functions
    result = await forge.enhance_agent(
        existing_code,
        "Add multiply and divide methods"
    )
    print(result.added_functions)  # ['_multiply', '_divide']

asyncio.run(main())
```

## Features

| Method | Purpose | Example |
|--------|---------|---------|
| `create_agent()` | Generate new agent from query | "Calculate shipping cost" |
| `improve_agent()` | Fix bugs from failure feedback | Inverted condition, wrong formula |
| `enhance_agent()` | Add missing logic/functions | "Add caching", "Add error handling" |

## Setup

### Google API Key (required)

FORGE uses Gemini LLM for code generation. A Google API Key is required.

```bash
export GOOGLE_API_KEY="your-google-api-key-here"
```

Get your API key: https://aistudio.google.com/apikey

## Requirements

- Python 3.10+
- Google API Key (`GOOGLE_API_KEY` environment variable)
- LogosAI framework (optional, for agent execution)

## License

Source code will be open-sourced after paper publication.
Part of the [LogosAI](https://github.com/maior) ecosystem.
