logosai-forge 0.2.1

AI Agent Generation Library — Agents Building Agents

logosai-forge

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

12 agentic AI agents collaborate to autonomously generate, improve, and enhance agent code.

Installation

pip install logosai-forge

Quick Start

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(broken_code, {
        "error_type": "logic_error",
        "error_message": "Expected approved but got denied",
        "test_input": {"score": 750},
        "expected_output": {"decision": "approved"},
        "actual_output": {"decision": "denied"},
    })
    print(result.diff)

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

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