# earlyai-agent

LLM-powered automatic test generation for Python.

## Status

🚧 **Currently in development** - API layer implemented, core functionality in progress.

## Installation

### Prerequisites

- Python 3.11+
- [uv](https://docs.astral.sh/uv/) (recommended)

### Install uv

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

### Install earlyai-agent

```bash
# Clone the repository
cd /Users/patron/work/py-agent

# Install just (one time)
brew install just

# Install dependencies
just install
```

## Development

We use [just](https://github.com/casey/just) as our command runner.

### Available commands

```bash
just              # List all available commands
just test         # Run tests
just test-cov     # Run tests with coverage
just lint         # Lint code
just format       # Format code
just check        # Type check
just all          # Run all checks
just clean        # Clean build artifacts
```

### Run a Python script
```bash
uv run python your_script.py
```

## Quick Start (WIP)

```python
import asyncio
from py_agent import PyAgent, PyAgentConfig


async def main():
    # Create agent
    agent = PyAgent()

    # Initialize with API key
    await agent.init(api_key="your-api-key")

    # Get testables (not yet implemented)
    # testables = await agent.get_testables("src/**/*.py")


if __name__ == "__main__":
    asyncio.run(main())
```

## License

commercial
