Merge pull request #191 from BrainBlend-AI/feature/uv-workspace

chore: migrate from Poetry to uv workspace

Author: KennyVaneetvelde

.github/workflows/code-quality.yml

@@ -21,48 +21,39 @@ jobs:
         with:
           python-version: '3.12'
 
-      - name: Install Poetry
-        run: |
-          python -m pip install --upgrade pip
-          pip install poetry
-
-      - name: Configure Poetry
-        run: |
-          poetry config virtualenvs.create true
-          poetry config virtualenvs.in-project true
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
 
-      - name: Cache Poetry virtualenv
+      - name: Cache uv
         uses: actions/cache@v4
         id: cache
         with:
-          path: ./.venv
-          key: venv-${{ runner.os }}-python-${{ runner.python-version }}-${{ hashFiles('**/poetry.lock') }}
+          path: ~/.cache/uv
+          key: uv-${{ runner.os }}-python-${{ runner.python-version }}-${{ hashFiles('**/uv.lock') }}
           restore-keys: |
-            venv-${{ runner.os }}-python-${{ runner.python-version }}-
-
-      - name: Select Python for Poetry
-        run: |
-          poetry env use $(which python)
+            uv-${{ runner.os }}-python-${{ runner.python-version }}-
 
       - name: Install Dependencies
         run: |
-          poetry install --with dev
-          poetry run pip list  # Verify installation
+          uv sync
+          uv run pip list  # Verify installation
 
       - name: Verify Black Installation
         run: |
-          poetry run which black || echo "Black not found"
-          poetry run black --version
+          uv run which black || echo "Black not found"
+          uv run black --version
 
       - name: Run Black Check
         run: |
-          poetry run black --check atomic-agents atomic-assembler atomic-examples atomic-forge
+          uv run black --check atomic-agents atomic-assembler atomic-examples atomic-forge
         if: success()
 
       - name: Run Flake8
-        run: poetry run flake8 --extend-exclude=.venv atomic-agents atomic-assembler atomic-examples atomic-forge
+        run: uv run flake8 --extend-exclude=.venv atomic-agents atomic-assembler atomic-examples atomic-forge
         if: success()
 
       - name: Run Tests
-        run: poetry run pytest --cov=atomic_agents atomic-agents
+        run: uv run pytest --cov=atomic_agents atomic-agents
         if: success()

.github/workflows/docs.yml

@@ -28,37 +28,39 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: '3.12'  # ensure consistency with project requirement
-          cache: 'pip'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
 
       - name: Install dependencies
         run: |
-          python -m pip install --upgrade pip
-          pip install poetry
-          poetry install
+          uv sync
 
       - name: Sync version from pyproject.toml
         run: |
-          poetry run python scripts/sync_version.py
-      
+          uv run python scripts/sync_version.py
+
       - name: Build singlehtml for documentation extraction
         run: |
           cd docs
-          poetry run make singlehtml
-      
+          uv run make singlehtml
+
       - name: Generate all llms.txt files
         run: |
-          poetry run python scripts/generate_llms_files.py
+          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
-          poetry run make html
-          
+          uv run make html
+
       - name: Verify llms files in build
         run: |
           echo "Checking for llms files in build directory:"

README.md

@@ -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

UPGRADE_DOC.md

@@ -7,9 +7,9 @@ Atomic Agents v2.0 introduces breaking changes to improve the developer experien
 ## Prerequisites
 
 - **Python Version**: Ensure your environment is running Python 3.12 or higher (v2.0 requires >=3.12)
-- **Update Dependencies**: 
+- **Update Dependencies**:
   ```bash
-  poetry update atomic-agents
+  uv sync
   # or
   pip install --upgrade atomic-agents>=2.0.0
   ```
@@ -467,8 +467,8 @@ This upgrade introduces breaking changes. All projects must be updated to use th
 ### YouTube API Update
 The YouTube API dependency has been updated to version 1.1.1 to resolve compatibility issues with lower versions.
 
-### Poetry Dependencies
-Examples and forge dependencies have been updated using `poetry update atomic-agents` to ensure compatibility with the new package structure.
+### Package Dependencies
+Examples and forge dependencies have been updated using `uv sync` to ensure compatibility with the new package structure.
 
 ## Version Information
 

agents.md

@@ -30,7 +30,7 @@ atomic-monorepo/
 ├── docs/                   # Sphinx documentation
 ├── guides/                 # Development guides
 ├── .github/workflows/      # CI/CD pipelines
-├── pyproject.toml          # Poetry configuration
+├── pyproject.toml          # Project configuration
 └── README.md              # Main documentation
 ```
 
@@ -183,7 +183,7 @@ Full support for MCP enables connection to external tools and resources through
 - **CLI Framework:** Textual (TUI), Rich (terminal formatting)
 - **Testing:** pytest with coverage
 - **Documentation:** Sphinx + MyST + ReadTheDocs theme
-- **Build System:** Poetry
+- **Build System:** uv (with hatchling)
 
 ### LLM Provider Compatibility
 
@@ -211,7 +211,7 @@ Through Instructor, Atomic Agents supports all major LLM providers:
 ### Prerequisites
 
 - Python ≥3.12, <4.0
-- Poetry (package manager)
+- [uv](https://docs.astral.sh/uv/) (package manager)
 
 ### Installation
 
@@ -221,23 +221,23 @@ git clone https://github.com/BrainBlend-AI/atomic-agents.git
 cd atomic-monorepo
 
 # Install dependencies
-poetry install
+uv sync
 
-# Activate virtual environment
-poetry shell
+# Install all workspace packages (examples and tools)
+uv sync --all-packages
 ```
 
 ### Development Commands
 
 ```bash
 # Code formatting
-poetry run black atomic-agents atomic-assembler atomic-examples atomic-forge
+uv run black atomic-agents atomic-assembler atomic-examples atomic-forge
 
 # Linting
-poetry run flake8 --extend-exclude=.venv atomic-agents atomic-assembler atomic-examples atomic-forge
+uv run flake8 --extend-exclude=.venv atomic-agents atomic-assembler atomic-examples atomic-forge
 
 # Testing
-poetry run pytest --cov=atomic_agents atomic-agents
+uv run pytest --cov=atomic_agents atomic-agents
 
 # Build documentation
 cd docs && make html

atomic-assembler/atomic_assembler/__init__.py

@@ -0,0 +1 @@
+# Atomic Assembler - CLI tool for assembling atomic projects

atomic-assembler/atomic_assembler/utils.py

@@ -84,7 +84,7 @@ def copy_atomic_tool(tool_path, destination):
             shutil.copytree(
                 tool_path,
                 local_tool_path,
-                ignore=shutil.ignore_patterns("requirements.txt", "pyproject.toml", ".coveragerc", "poetry.lock"),
+                ignore=shutil.ignore_patterns("requirements.txt", "pyproject.toml", ".coveragerc", "uv.lock"),
             )
             logging.info(f"Tool successfully copied to {local_tool_path}")
             return local_tool_path

atomic-examples/basic-multimodal/README.md

@@ -27,10 +27,10 @@ This example demonstrates how to use the Atomic Agents framework to analyze imag
    cd atomic-agents/atomic-examples/basic-multimodal
    ```
 
-3. Install dependencies using Poetry:
+3. Install dependencies using uv:
 
    ```bash
-   poetry install
+   uv sync
    ```
 
 4. Set up environment variables:
@@ -45,7 +45,7 @@ This example demonstrates how to use the Atomic Agents framework to analyze imag
 5. Run the example:
 
    ```bash
-   poetry run python basic_multimodal/main.py
+   uv run python basic_multimodal/main.py
    ```
 
 ## Components