Metadata-Version: 2.4
Name: flash-agents
Version: 0.1.0
Summary: A Python library for building flash agents
Project-URL: Homepage, https://github.com/yourusername/flash-agents
Project-URL: Repository, https://github.com/yourusername/flash-agents
Project-URL: Issues, https://github.com/yourusername/flash-agents/issues
Author-email: Your Name <you@example.com>
License: MIT
Keywords: agents,ai,llm
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Provides-Extra: dev
Requires-Dist: mypy>=1.9; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Description-Content-Type: text/markdown

# flash-agents

A template Python library for building agents — powered by [uv](https://docs.astral.sh/uv/).

## Installation

```bash
pip install flash-agents
```

Or with uv:

```bash
uv add flash-agents
```

## Quick Start

```python
from flash_agents import Agent

class MyAgent(Agent):
    def run(self, input: str, **kwargs) -> str:
        return f"Result: {input}"

agent = MyAgent()
print(agent.run("hello"))
```

## Development Setup

```bash
# Clone the repo
git clone https://github.com/yourusername/flash-agents.git
cd flash-agents

# Install with dev dependencies using uv
uv sync --all-extras --dev

# Run tests
uv run pytest

# Lint
uv run ruff check .

# Format
uv run ruff format .

# Type check
uv run mypy src/
```

## Project Layout

```
flash-agents/
├── src/
│   └── flash_agents/
│       ├── __init__.py        # Public API
│       ├── agent.py           # Abstract Agent base class
│       ├── py.typed           # PEP 561 marker
│       └── examples/
│           └── echo_agent.py  # Minimal example
├── tests/
│   └── test_agent.py
├── .github/
│   └── workflows/
│       └── publish.yml        # Auto-publish to PyPI on version tags
├── pyproject.toml
└── README.md
```

## Publishing to PyPI

See [PUBLISHING.md](PUBLISHING.md) for step-by-step upload instructions.

## License

MIT
