feat: initial release of SIARE open-source core

Self-Improving Agentic RAG Engine - evolve multi-agent RAG pipelines
using Quality-Diversity optimization.

Core components:
- ProcessConfig and data models for pipeline definition
- DirectorService for AI-driven evolution
- ExecutionEngine for multi-agent DAG execution
- GenePool for SOP versioning and ancestry tracking
- QDGridManager for Quality-Diversity optimization
- Evaluation service with LLM Judge metrics
- Prompt evolution strategies (TextGrad, EvoPrompt, MetaPrompt)
- Hallucination detection (faithfulness, groundedness, citation)
- Comprehensive benchmark suite (HotpotQA, Natural Questions, BEIR)

New features:
- Hooks architecture for enterprise extensibility
- Interactive CLI (siare init, siare evolve, siare run)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>

Author: danielbentes

.github/workflows/ci.yml

@@ -0,0 +1,78 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev,full]"
+
+      - name: Run linting
+        run: |
+          ruff check siare/
+
+      - name: Run type checking
+        run: |
+          pyright siare/
+
+      - name: Run tests
+        run: |
+          pytest tests/ -v --cov=siare --cov-report=xml
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        if: matrix.python-version == '3.11'
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        run: |
+          python -m build
+
+      - name: Check package
+        run: |
+          twine check dist/*
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

.gitignore

@@ -0,0 +1,76 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# macOS
+.DS_Store
+
+# SIARE specific
+.siare/
+siare.yaml
+example_docs/
+*.log

CONTRIBUTING.md

@@ -0,0 +1,60 @@
+# Contributing to SIARE
+
+Thank you for your interest in contributing to SIARE! This document provides guidelines for contributing.
+
+## Getting Started
+
+1. Fork the repository
+2. Clone your fork: `git clone https://github.com/YOUR_USERNAME/siare.git`
+3. Create a virtual environment: `python -m venv venv && source venv/bin/activate`
+4. Install dev dependencies: `pip install -e ".[dev,full]"`
+
+## Development Workflow
+
+1. Create a feature branch: `git checkout -b feature/your-feature`
+2. Make your changes
+3. Run tests: `pytest tests/ -v`
+4. Run linting: `ruff check siare/`
+5. Run type checking: `pyright siare/`
+6. Commit your changes with a descriptive message
+7. Push and create a pull request
+
+## Code Style
+
+- Follow PEP 8
+- Use type hints for all public functions
+- Write docstrings for public classes and functions
+- Keep functions focused and small
+- Add tests for new functionality
+
+## Testing
+
+- Unit tests go in `tests/unit/`
+- Integration tests go in `tests/integration/`
+- Test file naming: `test_<module_name>.py`
+- Test function naming: `test_<function>_<scenario>_<expected>`
+
+## Pull Request Guidelines
+
+- Keep PRs focused on a single change
+- Include tests for new functionality
+- Update documentation as needed
+- Ensure CI passes before requesting review
+- Write a clear PR description
+
+## Reporting Issues
+
+When reporting bugs, please include:
+- Python version
+- SIARE version
+- Steps to reproduce
+- Expected vs actual behavior
+- Relevant logs or error messages
+
+## Questions?
+
+Open a GitHub Discussion or reach out to the maintainers.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.