atomic-agents 2.2.2__tar.gz → 2.3.0__tar.gz

atomic_agents-2.3.0/.coveragerc

@@ -0,0 +1,14 @@
+[report]
+show_missing=true
+exclude_lines =
+    @abstractmethod
+    @abc.abstractmethod
+    if __name__ == .__main__.:
+    if __name__ == '__main__':
+    pragma: no cover
+    # pragma: no cover
+
+[run]
+omit =
+    */__init__.py
+    */tests/*

atomic_agents-2.3.0/.flake8

@@ -0,0 +1,12 @@
+[flake8]
+max-line-length = 150
+max-complexity = 10
+count = true
+statistics = true
+ignore = E203, W293, W503
+exclude = .venv,venv,__pycache__,build,dist
+
+per-file-ignores =
+    */__main__.py:C901
+    */*:C901
+

atomic_agents-2.3.0/.github/funding.yml

@@ -0,0 +1 @@
+github: KennyVaneetvelde

atomic_agents-2.3.0/.github/workflows/code-quality.yml

@@ -0,0 +1,59 @@
+name: Code Quality & Tests
+
+on:
+  push:
+    branches: [ main, v2.0 ]
+  pull_request:
+    branches: [ main, v2.0 ]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Cache uv
+        uses: actions/cache@v4
+        id: cache
+        with:
+          path: ~/.cache/uv
+          key: uv-${{ runner.os }}-python-${{ runner.python-version }}-${{ hashFiles('**/uv.lock') }}
+          restore-keys: |
+            uv-${{ runner.os }}-python-${{ runner.python-version }}-
+
+      - name: Install Dependencies
+        run: |
+          uv sync
+          uv run pip list  # Verify installation
+
+      - name: Verify Black Installation
+        run: |
+          uv run which black || echo "Black not found"
+          uv run black --version
+
+      - name: Run Black Check
+        run: |
+          uv run black --check atomic-agents atomic-assembler atomic-examples atomic-forge
+        if: success()
+
+      - name: Run Flake8
+        run: uv run flake8 --extend-exclude=.venv atomic-agents atomic-assembler atomic-examples atomic-forge
+        if: success()
+
+      - name: Run Tests
+        run: uv run pytest --cov=atomic_agents atomic-agents
+        if: success()

atomic_agents-2.3.0/.github/workflows/docs.yml

@@ -0,0 +1,84 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main  # or your default branch
+  workflow_dispatch:  # Allows manual triggering
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'  # ensure consistency with project requirement
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Install dependencies
+        run: |
+          uv sync
+
+      - name: Sync version from pyproject.toml
+        run: |
+          uv run python scripts/sync_version.py
+
+      - name: Build singlehtml for documentation extraction
+        run: |
+          cd docs
+          uv run make singlehtml
+
+      - name: Generate all llms.txt files
+        run: |
+          uv run python scripts/generate_llms_files.py
+          # Copy to _static directory for Sphinx to process during build
+          mkdir -p docs/_static
+          cp docs/llms-*.txt docs/_static/
+          echo "Generated llms files:"
+          ls -lh docs/_static/llms-*.txt
+
+      - name: Build HTML documentation
+        run: |
+          cd docs
+          uv run make html
+
+      - name: Verify llms files in build
+        run: |
+          echo "Checking for llms files in build directory:"
+          ls -lh docs/_build/html/_static/llms-*.txt || echo "Files not in _static"
+          ls -lh docs/_build/html/_downloads/*/llms-*.txt || echo "Files not in _downloads"
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_build/html
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

atomic_agents-2.3.0/.gitignore

@@ -0,0 +1,158 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+site-packages/
+
+# Virtual environments
+.env
+.env.*
+.venv
+.venv.*
+env/
+env.bak/
+venv/
+venv.bak/
+ENV/
+
+# 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/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff
+instance/
+.webassets-cache
+
+# Scrapy stuff
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+docs/llms-*.txt
+docs/llms.txt
+docs/_static/llms-*.txt
+docs/examples/source/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# Chroma related
+chromadb_persist/
+chroma_data/
+chromadb_tmp/
+
+# IDEs and editors
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Operating System Files
+.DS_Store
+Thumbs.db
+
+# Project specific
+personal_experiments/
+personal_scripts/
+*.psd
+.output/
+
+# Logs
+debug.log
+
+# AI tools
+.claude
+CLAUDE.md
+CLAUDE.local.md
+.serena

{atomic_agents-2.2.2 → atomic_agents-2.3.0}/PKG-INFO

@@ -1,26 +1,22 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: atomic-agents
-Version: 2.2.2
+Version: 2.3.0
 Summary: A versatile framework for creating and managing intelligent agents.
-License: MIT
-Author: Kenny Vaneetvelde
-Author-email: kenny.vaneetvelde@gmail.com
-Requires-Python: >=3.12,<4.0
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: gitpython (>=3.1.43,<4.0.0)
-Requires-Dist: instructor (==1.9.2)
-Requires-Dist: mcp[cli] (>=1.6.0,<2.0.0)
-Requires-Dist: pydantic (>=2.11.0,<3.0.0)
-Requires-Dist: pyfiglet (>=1.0.2,<2.0.0)
-Requires-Dist: pyyaml (>=6.0.2,<7.0.0)
-Requires-Dist: requests (>=2.32.3,<3.0.0)
-Requires-Dist: rich (>=13.7.1,<14.0.0)
-Requires-Dist: textual (>=5.3.0,<6.0.0)
 Project-URL: Homepage, https://github.com/BrainBlend-AI/atomic-agents
 Project-URL: Repository, https://github.com/BrainBlend-AI/atomic-agents
+Author-email: Kenny Vaneetvelde <kenny.vaneetvelde@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: gitpython<4.0.0,>=3.1.43
+Requires-Dist: instructor==1.13.0
+Requires-Dist: mcp[cli]>=1.6.0
+Requires-Dist: pydantic<3.0.0,>=2.11.0
+Requires-Dist: pyfiglet<2.0.0,>=1.0.2
+Requires-Dist: pyyaml<7.0.0,>=6.0.2
+Requires-Dist: requests<3.0.0,>=2.32.3
+Requires-Dist: rich<14.0.0,>=13.7.1
+Requires-Dist: textual<6.0.0,>=5.3.0
 Description-Content-Type: text/markdown
 
 # Atomic Agents
@@ -137,7 +133,7 @@ client = instructor.from_openai(OpenAI())
 agent = AtomicAgent[BasicChatInputSchema, CustomOutputSchema](
     config=AgentConfig(
         client=client,
-        model="gpt-4o-mini",
+        model="gpt-5-mini",
         system_prompt_generator=system_prompt_generator,
         history=ChatHistory(),
     )
@@ -244,7 +240,7 @@ class QueryAgentInputSchema(BaseIOSchema):
 query_agent = AtomicAgent[QueryAgentInputSchema, SearXNGSearchTool.input_schema](
     config=AgentConfig(
         client=instructor.from_openai(openai.OpenAI()),
-        model="gpt-4o-mini",
+        model="gpt-5-mini",
         system_prompt_generator=SystemPromptGenerator(
             background=[
                 "You are an intelligent query generation expert.",
@@ -344,13 +340,7 @@ To run the CLI, simply run the following command:
 atomic
 ```
 
-Or if you installed Atomic Agents with Poetry, for example:
-
-```bash
-poetry run atomic
-```
-
-Or if you installed Atomic Agents with uv:
+Or if you're running from a cloned repository with uv:
 
 ```bash
 uv run atomic
@@ -388,7 +378,13 @@ For local development, you can install from the repository:
 ```bash
 git clone https://github.com/BrainBlend-AI/atomic-agents.git
 cd atomic-agents
-poetry install
+uv sync
+```
+
+To install all workspace packages (examples and tools):
+
+```bash
+uv sync --all-packages
 ```
 
 ## Provider & Model Compatibility
@@ -402,9 +398,9 @@ We welcome contributions! Please see the [Contributing Guide](/docs/contributing
 1. Fork the repository
 2. Create a new branch (`git checkout -b feature-branch`)
 3. Make your changes
-4. Run tests (`poetry run pytest --cov=atomic_agents atomic-agents`)
-5. Format your code (`poetry run black atomic-agents atomic-assembler atomic-examples atomic-forge`)
-6. Lint your code (`poetry run flake8 --extend-exclude=.venv atomic-agents atomic-assembler atomic-examples atomic-forge`)
+4. Run tests (`uv run pytest --cov=atomic_agents atomic-agents`)
+5. Format your code (`uv run black atomic-agents atomic-assembler atomic-examples atomic-forge`)
+6. Lint your code (`uv run flake8 --extend-exclude=.venv atomic-agents atomic-assembler atomic-examples atomic-forge`)
 7. Commit your changes (`git commit -m 'Add some feature'`)
 8. Push to the branch (`git push origin feature-branch`)
 9. Open a pull request
@@ -427,4 +423,3 @@ If you want to learn more about the motivation and philosophy behind Atomic Agen
 
 [![Star History Chart](https://api.star-history.com/svg?repos=BrainBlend-AI/atomic-agents&type=Date)](https://star-history.com/#BrainBlend-AI/atomic-agents&Date)
 
-

{atomic_agents-2.2.2 → atomic_agents-2.3.0}/README.md

@@ -112,7 +112,7 @@ client = instructor.from_openai(OpenAI())
 agent = AtomicAgent[BasicChatInputSchema, CustomOutputSchema](
     config=AgentConfig(
         client=client,
-        model="gpt-4o-mini",
+        model="gpt-5-mini",
         system_prompt_generator=system_prompt_generator,
         history=ChatHistory(),
     )
@@ -219,7 +219,7 @@ class QueryAgentInputSchema(BaseIOSchema):
 query_agent = AtomicAgent[QueryAgentInputSchema, SearXNGSearchTool.input_schema](
     config=AgentConfig(
         client=instructor.from_openai(openai.OpenAI()),
-        model="gpt-4o-mini",
+        model="gpt-5-mini",
         system_prompt_generator=SystemPromptGenerator(
             background=[
                 "You are an intelligent query generation expert.",
@@ -319,13 +319,7 @@ To run the CLI, simply run the following command:
 atomic
 ```
 
-Or if you installed Atomic Agents with Poetry, for example:
-
-```bash
-poetry run atomic
-```
-
-Or if you installed Atomic Agents with uv:
+Or if you're running from a cloned repository with uv:
 
 ```bash
 uv run atomic
@@ -363,7 +357,13 @@ For local development, you can install from the repository:
 ```bash
 git clone https://github.com/BrainBlend-AI/atomic-agents.git
 cd atomic-agents
-poetry install
+uv sync
+```
+
+To install all workspace packages (examples and tools):
+
+```bash
+uv sync --all-packages
 ```
 
 ## Provider & Model Compatibility
@@ -377,9 +377,9 @@ We welcome contributions! Please see the [Contributing Guide](/docs/contributing
 1. Fork the repository
 2. Create a new branch (`git checkout -b feature-branch`)
 3. Make your changes
-4. Run tests (`poetry run pytest --cov=atomic_agents atomic-agents`)
-5. Format your code (`poetry run black atomic-agents atomic-assembler atomic-examples atomic-forge`)
-6. Lint your code (`poetry run flake8 --extend-exclude=.venv atomic-agents atomic-assembler atomic-examples atomic-forge`)
+4. Run tests (`uv run pytest --cov=atomic_agents atomic-agents`)
+5. Format your code (`uv run black atomic-agents atomic-assembler atomic-examples atomic-forge`)
+6. Lint your code (`uv run flake8 --extend-exclude=.venv atomic-agents atomic-assembler atomic-examples atomic-forge`)
 7. Commit your changes (`git commit -m 'Add some feature'`)
 8. Push to the branch (`git push origin feature-branch`)
 9. Open a pull request