agentic-swarm 0.1.0__tar.gz

agentic_swarm-0.1.0/.agentic_swarm_demo/demo_documents_ingested.json

@@ -0,0 +1 @@
+{"key": "demo:documents_ingested", "value": {"value": 5, "type": "int"}, "ttl": null, "created_at": 1779473500.053659}

agentic_swarm-0.1.0/.agentic_swarm_demo/demo_last_query.json

@@ -0,0 +1 @@
+{"key": "demo:last_query", "value": {"value": "multi-agent systems", "type": "str"}, "ttl": null, "created_at": 1779473500.053344}

agentic_swarm-0.1.0/.agentic_swarm_demo/demo_session_id.json

@@ -0,0 +1 @@
+{"key": "demo:session_id", "value": {"value": "demo_001", "type": "str"}, "ttl": null, "created_at": 1779473500.0537841}

agentic_swarm-0.1.0/.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,57 @@
+# Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+* The use of sexualized language or imagery, and sexual attention or advances
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information without explicit permission
+* Other conduct which could reasonably be considered inappropriate
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT EMAIL].
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org),
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.

agentic_swarm-0.1.0/.github/CONTRIBUTING.md

@@ -0,0 +1,153 @@
+# Contributing to Agentic Swarm
+
+Thank you for your interest in contributing to Agentic Swarm! This document provides guidelines and instructions for contributing.
+
+## Code of Conduct
+
+By participating in this project, you agree to abide by our [Code of Conduct](CODE_OF_CONDUCT.md).
+
+## How to Contribute
+
+### Reporting Issues
+
+Before creating an issue, please:
+
+1. **Search existing issues** to avoid duplicates
+2. **Use the issue template** and include:
+   - Python version (`python --version`)
+   - SDK version (`pip show agentic-swarm`)
+   - Full error traceback
+   - Minimal reproducible example
+   - Expected vs actual behavior
+
+### Submitting Pull Requests
+
+1. **Fork** the repository
+2. **Create a feature branch**: `git checkout -b feature/my-feature`
+3. **Write tests** for your changes
+4. **Ensure all tests pass**: `pytest tests/ -v`
+5. **Lint your code**: `ruff check agentic_swarm/`
+6. **Format your code**: `ruff format agentic_swarm/`
+7. **Commit** with clear messages
+8. **Push** and open a PR against `main`
+
+### Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/nik0811/agentic-swarm.git
+cd agentic-swarm
+
+# Create virtual environment
+python -m venv env
+source env/bin/activate  # On Windows: env\Scripts\activate
+
+# Install in development mode with all dependencies
+pip install -e ".[dev,all]"
+
+# Run tests
+pytest tests/ -v
+
+# Run linter
+ruff check agentic_swarm/
+
+# Run formatter
+ruff format agentic_swarm/
+```
+
+## Code Style
+
+### General Guidelines
+
+- **Line length**: 100 characters max
+- **Type hints**: Required for all public APIs
+- **Docstrings**: Google style for public methods
+- **Tests**: pytest + pytest-asyncio for async tests
+
+### Commit Message Format
+
+Use clear, descriptive commit messages:
+
+| Prefix | Meaning |
+|--------|---------|
+| `Add:` | New feature |
+| `Fix:` | Bug fix |
+| `Update:` | Enhancement to existing feature |
+| `Refactor:` | Code restructuring (no behavior change) |
+| `Docs:` | Documentation only |
+| `Test:` | Test additions/modifications |
+| `Chore:` | Build, CI, or tooling changes |
+
+Examples:
+```
+Add: Support for Groq LLM provider
+Fix: Memory leak in agent spawning
+Update: Improve RAG retrieval accuracy
+Docs: Add configuration guide
+```
+
+### Code Review Process
+
+1. All PRs require at least one approval
+2. CI must pass (tests, lint, type check)
+3. No decrease in test coverage
+4. Documentation updated if needed
+
+## Testing
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest tests/ -v
+
+# Run specific test file
+pytest tests/test_agent.py -v
+
+# Run with coverage
+pytest tests/ --cov=agentic_swarm --cov-report=html
+
+# Run only fast tests (skip slow integration tests)
+pytest tests/ -v -m "not slow"
+```
+
+### Writing Tests
+
+- Place tests in `tests/` directory
+- Name test files `test_*.py`
+- Use `pytest.mark.asyncio` for async tests
+- Mock external services (LLM APIs, databases)
+
+Example:
+```python
+import pytest
+from agentic_swarm import Agent
+
+@pytest.mark.asyncio
+async def test_agent_creation():
+    agent = Agent(name="test", role="tester")
+    assert agent.name == "test"
+    assert agent.role == "tester"
+```
+
+## Documentation
+
+- Update docstrings for any API changes
+- Update `docs/` for new features
+- Include code examples where helpful
+- Keep README.md concise; detailed docs go in `docs/`
+
+## Security
+
+- **Never commit credentials** or API keys
+- Use environment variables for secrets
+- Report security vulnerabilities privately to maintainers
+- Follow secure coding practices
+
+## Questions?
+
+- Open a [Discussion](https://github.com/nik0811/agentic-swarm/discussions) for questions
+- Check existing issues and discussions first
+- Be respectful and constructive
+
+Thank you for contributing! 🎉

agentic_swarm-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,51 @@
+---
+name: Bug Report
+about: Report a bug or unexpected behavior
+title: "[Bug]: "
+labels: bug
+assignees: ''
+---
+
+## Description
+
+A clear and concise description of the bug.
+
+## Environment
+
+- **OS**: [e.g., macOS 14.0, Ubuntu 22.04, Windows 11]
+- **Python version**: [e.g., 3.11.5]
+- **agentic-swarm version**: [e.g., 1.0.0]
+
+## Steps to Reproduce
+
+1. Step one
+2. Step two
+3. ...
+
+## Minimal Reproducible Example
+
+```python
+# Paste minimal code that reproduces the issue
+from agentic_swarm import Agent
+
+agent = Agent(name="test", role="tester")
+# ...
+```
+
+## Expected Behavior
+
+What you expected to happen.
+
+## Actual Behavior
+
+What actually happened.
+
+## Error Traceback
+
+```
+Paste the full error traceback here
+```
+
+## Additional Context
+
+Add any other context about the problem here.

agentic_swarm-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,35 @@
+---
+name: Feature Request
+about: Suggest a new feature or enhancement
+title: "[Feature]: "
+labels: enhancement
+assignees: ''
+---
+
+## Problem Statement
+
+A clear description of the problem you're trying to solve.
+
+## Proposed Solution
+
+Describe the solution you'd like.
+
+## Example Usage
+
+```python
+# How would this feature be used?
+from agentic_swarm import Agent
+
+agent = Agent(
+    name="test",
+    new_feature=True,  # Example of new feature
+)
+```
+
+## Alternatives Considered
+
+Describe any alternative solutions or features you've considered.
+
+## Additional Context
+
+Add any other context, screenshots, or examples about the feature request.

agentic_swarm-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,44 @@
+## Description
+
+Brief description of the changes in this PR.
+
+## Type of Change
+
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] Documentation update
+- [ ] Refactoring (no functional changes)
+
+## Related Issues
+
+Fixes #(issue number)
+
+## Changes Made
+
+- Change 1
+- Change 2
+- ...
+
+## Testing
+
+- [ ] I have added tests that prove my fix/feature works
+- [ ] All new and existing tests pass (`pytest tests/ -v`)
+- [ ] I have run the linter (`ruff check agentic_swarm/`)
+
+## Documentation
+
+- [ ] I have updated the documentation accordingly
+- [ ] I have updated the CHANGELOG.md (if applicable)
+
+## Screenshots (if applicable)
+
+Add screenshots to help explain your changes.
+
+## Checklist
+
+- [ ] My code follows the project's style guidelines
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code where necessary
+- [ ] My changes generate no new warnings
+- [ ] I have checked that there are no credential leaks

agentic_swarm-0.1.0/.github/SECURITY.md

@@ -0,0 +1,88 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 0.1.x   | :white_check_mark: |
+
+## Reporting a Vulnerability
+
+We take security seriously. If you discover a security vulnerability, please report it responsibly.
+
+### How to Report
+
+1. **Do NOT** open a public GitHub issue for security vulnerabilities
+2. Email the maintainers directly at [INSERT SECURITY EMAIL]
+3. Include:
+   - Description of the vulnerability
+   - Steps to reproduce
+   - Potential impact
+   - Suggested fix (if any)
+
+### What to Expect
+
+- **Acknowledgment**: Within 48 hours
+- **Initial Assessment**: Within 7 days
+- **Resolution Timeline**: Depends on severity
+  - Critical: 24-48 hours
+  - High: 7 days
+  - Medium: 30 days
+  - Low: 90 days
+
+### Security Best Practices
+
+When using Agentic Swarm:
+
+1. **Never commit credentials**
+   - Use environment variables for API keys
+   - Add `.env` files to `.gitignore`
+
+2. **Use encryption for sensitive data**
+   ```python
+   from agentic_swarm.compliance import Encryption
+   
+   crypto = Encryption(Encryption.generate_key())
+   encrypted = crypto.encrypt("sensitive data")
+   ```
+
+3. **Enable data isolation in production**
+   ```python
+   agent = Agent(
+       name="secure_agent",
+       enable_isolation=True,
+       tenant_id="your_tenant",
+   )
+   ```
+
+4. **Use audit logging**
+   ```python
+   from agentic_swarm.compliance import AuditLogger
+   
+   audit = AuditLogger(log_path="./audit.log")
+   ```
+
+5. **Set appropriate sandbox limits**
+   ```python
+   from agentic_swarm.lifecycle import SandboxConfig
+   
+   config = SandboxConfig(
+       memory_limit_mb=256,
+       timeout_seconds=30,
+       allow_network=False,
+   )
+   ```
+
+## Security Features
+
+Agentic Swarm includes built-in security features:
+
+- **Audit Logging**: Immutable logs with tamper-proof checksums
+- **Encryption**: AES-256 encryption at rest with key rotation
+- **Data Isolation**: Namespace-based agent isolation
+- **Access Control**: Fine-grained RBAC for permissions, tools, and models
+- **Sandbox Execution**: CPU, memory, and timeout limits
+
+## Acknowledgments
+
+We appreciate responsible disclosure and will acknowledge security researchers who report valid vulnerabilities.

agentic_swarm-0.1.0/.github/release-please/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0"
+}

agentic_swarm-0.1.0/.github/release-please/release-please-config.json

@@ -0,0 +1,15 @@
+{
+  "packages": {
+    ".": {
+      "package-name": "agentic-swarm",
+      "changelog-path": "docs/CHANGELOG.md",
+      "release-type": "python",
+      "bump-minor-pre-major": true,
+      "bump-patch-for-minor-pre-major": true,
+      "extra-files": [
+        "agentic_swarm/__init__.py"
+      ]
+    }
+  },
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json"
+}

agentic_swarm-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,131 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+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 ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Cache pip dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: |
+          pytest tests/ -v --tb=short --cov=agentic_swarm --cov-report=xml
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        if: matrix.python-version == '3.11'
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install linters
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff mypy
+
+      - name: Run Ruff (linter)
+        run: ruff check agentic_swarm/ --output-format=github
+
+      - name: Run Ruff (formatter check)
+        run: ruff format agentic_swarm/ --check
+
+  type-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+          pip install mypy types-redis
+
+      - name: Run mypy
+        run: mypy agentic_swarm/ --ignore-missing-imports --no-error-summary || true
+
+  security:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install bandit
+        run: pip install bandit[toml]
+
+      - name: Run security scan
+        run: bandit -r agentic_swarm/ -c pyproject.toml || true
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [test, lint]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        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 build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

agentic_swarm-0.1.0/.github/workflows/dependency-review.yml

@@ -0,0 +1,21 @@
+name: Dependency Review
+
+on:
+  pull_request:
+    branches: [master]
+
+permissions:
+  contents: read
+
+jobs:
+  dependency-review:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Dependency Review
+        uses: actions/dependency-review-action@v4
+        with:
+          fail-on-severity: high
+          deny-licenses: GPL-3.0, AGPL-3.0

agentic_swarm-0.1.0/.github/workflows/release-please.yml

@@ -0,0 +1,62 @@
+name: Release Please
+
+on:
+  push:
+    branches: [master]
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+      version: ${{ steps.release.outputs.version }}
+    steps:
+      - name: Release Please
+        id: release
+        uses: googleapis/release-please-action@v4
+        with:
+          release-type: python
+          package-name: agentic-swarm
+          token: ${{ secrets.GITHUB_TOKEN }}
+          config-file: .github/release-please/release-please-config.json
+          manifest-file: .github/release-please/.release-please-manifest.json
+
+  publish:
+    needs: release-please
+    if: ${{ needs.release-please.outputs.release_created }}
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/agentic-swarm
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.release-please.outputs.tag_name }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        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: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true