Metadata-Version: 2.4
Name: sia-agent
Version: 0.1.1
Summary: SIA: Self-Improving Auto-researcher — an autonomous AI scientist framework
Author-email: Hexo <sia@hexo.ai>
License-Expression: MIT
Project-URL: Homepage, https://github.com/hexo/sia
Project-URL: Repository, https://github.com/hexo/sia
Keywords: ai,research,self-improving,agents,science
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
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
Description-Content-Type: text/markdown

# SIA (Self-Improving Auto-researcher)

A framework for building self-improving AI agents that autonomously refine their performance on scientific tasks.

## Installation

```bash
pip install sia-agent
```

## Usage

```python
from sia import Generation, GenerationLog, ScoreTracker

# Track generations in a self-improvement loop
log = GenerationLog()

gen = log.new_generation(config={"model": "claude-sonnet", "temperature": 0.7})
# ... run your agent ...
gen.finish(result={"accuracy": 0.82})

gen = log.new_generation(config={"model": "claude-sonnet", "temperature": 0.5})
# ... run improved agent ...
gen.finish(result={"accuracy": 0.91})

# Find the best generation
best = log.best("accuracy")
print(best.generation_id, best.result)  # 1 {'accuracy': 0.91}

# Save and reload logs
log.save("run_log.json")
log = GenerationLog.load("run_log.json")

# Track scores across generations
tracker = ScoreTracker()
tracker.record("accuracy", 0.82)
tracker.record("accuracy", 0.91)

summary = tracker.summarise("accuracy")
print(summary.improvement)   # 0.09
print(summary.is_improving)  # True
```

## License

MIT
