open-swarm 0.1.1745275181__py3-none-any.whl → 0.1.1748636295__py3-none-any.whl

open_swarm-0.1.1748636295.dist-info/METADATA

@@ -0,0 +1,257 @@
+Metadata-Version: 2.4
+Name: open-swarm
+Version: 0.1.1748636295
+Summary: A tool for orchestrating Swarm using both CLI and API.
+Author-email: Matthew Hand <matthewhandau@gmail.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiofiles>=24.1.0
+Requires-Dist: aiohttp>=3.11.11
+Requires-Dist: asyncio>=3.4.3
+Requires-Dist: asynctest>=0.13.0
+Requires-Dist: channels>=4.2.0
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: django<5.0,>=4.2
+Requires-Dist: django-allauth>=65.3.1
+Requires-Dist: django-template-debug>=0.3.5
+Requires-Dist: djangorestframework>=3.15.2
+Requires-Dist: flask>=3.1.0
+Requires-Dist: jmespath>=1.0.1
+Requires-Dist: jsonschema-pydantic>=0.6
+Requires-Dist: mcp>=1.2.0
+Requires-Dist: openai>=1.58.1
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: redis>=5.2.1
+Requires-Dist: requests>=2.32.3
+Requires-Dist: whitenoise>=6.8.2
+Requires-Dist: drf-spectacular>=0.23.0
+Requires-Dist: pyinstaller>=6.12.0
+Requires-Dist: tiktoken>=0.9.0
+Requires-Dist: django-cors-headers>=4.7.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3.4; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.25.1; extra == "dev"
+Requires-Dist: pytest-cov>=6.0.0; extra == "dev"
+Requires-Dist: pytest-django>=4.9.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.14.0; extra == "dev"
+Requires-Dist: python-semantic-release>=9.20.0; extra == "dev"
+Provides-Extra: experimental
+Requires-Dist: nemoguardrails>=0.11.0; extra == "experimental"
+Dynamic: license-file
+
+# Open Swarm
+
+<div align="center">
+<img src="assets/images/openswarm-project-image.jpg" alt="Project Logo" width="70%"/>
+</div>
+
+**Open Swarm** is a versatile, modular framework for building intelligent, multi-agent systems. It's a **fork and actively maintained extension** of the [OpenAI Swarm](https://github.com/openai/swarm) framework. It includes modifications to support stateless RESTful operations and a plugin system for custom extensions that enhance agentic workflows.
+
+---
+
+https://github.com/user-attachments/assets/1335f7fb-ff61-4e96-881c-7d3154eb9f14
+
+(generated by www.gitpodcast.com)
+
+---
+
+## Table of Contents
+- [Key Features](#key-features)
+- [Quickstart](#quickstart)
+- [Blueprints](#blueprints)
+- [Further Documentation](#further-documentation)
+- [License](#license)
+- [Acknowledgements](#acknowledgements)
+
+---
+
+## Key Features
+
+1. **Multi-Agent Orchestration**  
+   - Define multiple agents, each with unique instructions and roles.
+   - Agents coordinate tasks, share context, or hand off queries between one another.
+
+2. **Blueprint-Driven Architecture**  
+   - Each **Blueprint** encapsulates logic, tool connections, and environment/config settings.
+   - Encourages reusable, modular patterns for different use cases.
+
+3. **Optional MCP Integration**  
+   - Integrate with external tools (e.g., databases, web search, filesystems) through **MCP servers**.
+   - Note `npx` MCP servers work great but `uvx` MCP servers currently have issues.
+
+4. **CLI & REST Interface**  
+   - Run from the command line or expose a Django-powered REST API for broader integration.
+   - Interactive web pages per blueprint at `/<blueprint_name>/`.
+
+5. **OpenAI API Compatibility**  
+   - Exposes an endpoint at `/v1/chat/completions` that is functionally similar to the OpenAI Chat Completions API.
+   - Includes a **mandatory** `sender` field in agent responses.  
+     - This field identifies which Swarm agent provided the response and must be preserved in the conversation history for proper handoffs between agents.
+     - While the framework is compatible with OpenAI-like API clients, it assumes the client application maintains the `sender` field and, ideally, displays it in the user interface.
+     - **Note:** Most OpenAI API-compatible applications will ignore the `sender` field by default and not display the agent name. Custom UI or logic is required to utilise and present this information.
+
+6. **Configurable LLMs**  
+   - Supports multiple OpenAI-compatible providers in a single environment (e.g., `openai`, `grok`, `ollama`).
+   - Allows specifying different models/providers for different agents—even within the same blueprint.
+   - Use environment variable `DEFAULT_LLM` to specify default LLM model used by blueprints, e.g., `DEFAULT_LLM=deepseek-r1-distill-llama-70b`
+
+---
+
+## Quickstart
+
+Follow these simple steps to get Open Swarm up and running:
+
+1. **Install the Package**  
+   Run:
+   ```bash
+   pip install open-swarm
+   ```
+
+2. **Configure an LLM Provider**  
+   When you run a blueprint for the first time, Open Swarm checks for a configuration file at `~/.swarm/swarm_config.json`. If the file is missing, it will automatically create a default configuration as shown below:
+   ```json
+   {
+       "llm": {
+           "default": {
+               "provider": "openai",
+               "model": "gpt-4o",
+               "base_url": "https://api.openai.com/v1",
+               "api_key": "${OPENAI_API_KEY}"
+           }
+       },
+       "mcpServers": {}
+   }
+   ```
+   Make sure to set the `OPENAI_API_KEY` environment variable with your valid OpenAI API key.
+
+   An example of using an alternative provider:
+
+   `swarm-cli config add --section llm --name deepseek-r1-distill-llama-70b --json '{"provider": "openai", "model": "deepseek-r1-distill-llama-70b", "base_url": "https://api.groq.com/openai/v1", "api_key": "${GROQ_API_KEY}"}' `
+
+
+3. **(Optional) Configure a Simple MCP Server**  
+   To add an MCP server for additional utilities (e.g., file fetching), use the `swarm-cli config add --json '<multiline_json_block>'`. For example:
+
+   ```json
+      "filesystem": {
+         "command": "npx",
+         "args": [
+               "-y",
+               "@modelcontextprotocol/server-filesystem ${ALLOWED_PATH}"
+         ],
+         "env": {
+               "ALLOWED_PATH": "${ALLOWED_PATH}"
+         }
+      }
+   ```
+
+4. **Add an Example Blueprint**  
+   Add an example blueprint by running:
+   ```bash
+   swarm-cli add /path/to/your/blueprint.py --name example
+   ```
+   This copies your blueprint into the managed blueprints directory.
+
+   Example blueprints are provided here: https://github.com/matthewhand/open-swarm/tree/main/blueprints
+
+5. **Run the Blueprint from CLI**  
+   Execute the blueprint with:
+   ```bash
+   swarm-cli run example
+   ```
+
+---
+
+## Overview
+
+Open Swarm provides the following core components:
+
+- **Swarm CLI:**  
+  A command-line tool for managing blueprints and configuration settings. It allows you to add, list, delete, run, and install blueprints, as well as update configuration entries for LLM providers and MCP servers.
+
+- **Swarm API:**  
+  An HTTP REST service that exposes endpoints such as `/v1/models` and `/v1/chat/completion(s)`. These endpoints let external applications interact with Open Swarm in an OpenAI API-compatible manner, publishing blueprints as models and processing chat completions.  Additional endpoints can be exposed via blueprints.
+
+- **Swarm SDK:**  
+  Open Swarm can be used as a Python module.  It is backwards compatible with the original OpenAI Swarm educational framework.  It also adds many extensions including configuration loading, MCP server integration, Python Django DB and REST features, etc etc.
+
+For detailed usage instructions, please refer to the [USERGUIDE.md](./USERGUIDE.md). For developer-specific guidance, see [DEVELOPMENT.md](./DEVELOPMENT.md).
+
+---
+
+
+## Blueprints
+
+A **Blueprint** is a Python module that wraps:
+
+- **Agent Logic**: Defines how each agent in the Swarm processes user messages, whether it calls tools, and how it decides to hand off to other agents.
+- **Tools**: Specifies which agents have which tools (e.g., MCP-discovered tools, Python function calls).
+- **Environment & Configuration**: Ensures required environment variables and JSON configs are validated prior to agent execution.
+
+Once registered, a blueprint is discoverable at runtime, allowing the system to list and load agents on demand.
+
+### Personal Assistant Example
+
+The **Personal Assistant Blueprint** demonstrates a hybrid approach, integrating **local Python function tools** with **MCP-discovered tools**. It consists of:
+
+1. **Personal Assistant Agent**  
+   - Determines user intent and delegates queries accordingly.  
+   - Routes weather-related queries to the `WeatherAgent`.  
+   - Routes knowledge-based queries to the `DocumentationAgent`.
+
+2. **Weather Agent** (Uses Python Function Tools)  
+   - Fetches current weather and forecasts via OpenWeatherMap.  
+   - Uses a **locally defined Python function** rather than an MCP server.  
+   - Requires `WEATHER_API_KEY` as an environment variable.
+
+3. **Documentation Agent** (Uses MCP-Discovered Tools)  
+   - Retrieves relevant documentation via `rag-docs`.  
+   - Uses the MCP function `search_documentation` to dynamically retrieve information.  
+   - Requires the following environment variables:  
+     - `OPENAI_API_KEY`  
+     - `QDRANT_URL`  
+     - `QDRANT_API_KEY`
+
+This blueprint highlights **seamless multi-agent coordination** and the **flexibility of combining Python functions with MCP-discovered tools**.
+
+### Other Examples
+
+Open Swarm includes a growing library of **Blueprint** examples:
+
+| Blueprint Name               | Description                                                                 | Status                                  |
+|------------------------------|-----------------------------------------------------------------------------|-----------------------------------------|
+| **Echo Blueprint**           | A straightforward agent that simply echoes user inputs—ideal for testing or as a starter template. | Stable                                  |
+| **Suggestion Blueprint**     | Blueprint providing suggestions and recommendations.                        | Stable                                  |
+| **Database and Web Blueprint** | Demonstrates MCP-based integration with an SQLite database and Brave Search, illustrating how to combine data retrieval with real-time web queries. | Stable                                  |
+| **University Blueprint**       | Multi-agent system for university-related tasks.                            | Stable                                  |
+| **Divine Ops Blueprint**       | Multi-agent system for handling system administration tasks using MCP tools (filesystem, SQLite, search, etc.). | Stable                                  |
+| **Nebucha Shellzzar Blueprint**| Example system administration blueprint.                                  | Stable                                  |
+| **Personal Assistant Blueprint** | Combines real-time weather updates (Python function) with documentation search (`rag-docs`, MCP). Demonstrates mixed tooling. | Broken (uvx-based)                      |
+| **Flowise Blueprint**          | Integrates with Flowise for visual flow orchestration.                      | Broken (uvx-based, requires Flowise setup)|
+
+---
+---
+
+## Further Documentation
+
+For advanced usage, sequence diagrams, or in-depth tooling examples, see [DEVELOPMENT.md](./DEVELOPMENT.md). Additional expansions and best practices for agent orchestration, LLM provider swapping, and more can be found in that document.
+
+---
+
+## License
+
+Open Swarm is provided under the MIT License. Refer to the [LICENSE](LICENSE) file for full details.
+
+---
+
+## Acknowledgements
+
+This project is based on the [OpenAI Swarm](https://github.com/openai/swarm) framework. We would like to acknowledge the original authors and contributors of this project for their work.  
+We also wish to credit [django_chatbot](https://github.com/MattiPaivike/django_chatbot) for the Django chatbot view.
+
+### Third-Party Libraries
+- **[Marked.js](https://github.com/markedjs/marked)** (MIT License)  
+  A fast, lightweight library for parsing Markdown into HTML.
+- **[Tabler Icons](https://tablericons.com)** (MIT License)  
+  A set of free, high-quality SVG icons for web projects, designed by Paweł Kuna.

open_swarm-0.1.1748636295.dist-info/RECORD

@@ -0,0 +1,89 @@
+open_swarm-0.1.1748636295.dist-info/licenses/LICENSE,sha256=BU9bwRlnOt_JDIb6OT55Q4leLZx9RArDLTFnlDIrBEI,1062
+swarm/__init__.py,sha256=N2hwTgbJPoezNcg9WQCK0rj6Ap7MuyprhkWSDTfb9pI,71
+swarm/apps.py,sha256=up4C3m2JeyXeUcH-wYeReCuiOBVJ6404w9OfaRChLwM,2568
+swarm/auth.py,sha256=WcajB6lrA2cSA-Ho1lnBEs9_MNtDx713sxHRvIXx9fQ,2415
+swarm/consumers.py,sha256=wESLamkhbi4SEZt9k3yx6eU9ufOIZMCAL-OAXjJBGXE,5056
+swarm/core.py,sha256=9SYH9JRs2OrSKdJrWK4OdcjmItpEEfY44ou7DSh_X94,22249
+swarm/messages.py,sha256=CwADrjlj-uVmm-so1xIZvN1UkEWdzSn_hu7slfhuS8w,6549
+swarm/models.py,sha256=Ix0WEYYqza2lbOEBNesikRCs3XGUPWmqQyMWzZYUaxM,1494
+swarm/serializers.py,sha256=EPvQHvUZtnOKX5ltddNFPGnWaJGxFDWFbofTa39oxgE,363
+swarm/settings.py,sha256=CQyql6M0NmARGTzaeQHogRDNCsiQp6orJ_hjSkxn8V0,7956
+swarm/tool_executor.py,sha256=KHM2mTGgbbTgWNN3fbV5c4MDY238OTLwaaqtkczFHFQ,12385
+swarm/types.py,sha256=3Uw7B4O1cvq2j8wuk7_xTrNSgpyOXzRzo8uS72PvXTY,3135
+swarm/urls.py,sha256=i7qIwlSMsMSMrOhkbiUfTEL7tdhRFY4g5prfBimKOX0,4085
+swarm/util.py,sha256=G4x2hXopHhB7IdGCkUXGoykYWyiICnjxg7wcr-WqL8I,4644
+swarm/wsgi.py,sha256=REM_u4HpMCkO0ddrOUXgtY-ITL-VTbRB1-WHvFJAtAU,408
+swarm/agent/__init__.py,sha256=YESGu_UXEBxrlQwghodUMN0vmXZDwWMU7DclCUvoklA,104
+swarm/agent/agent.py,sha256=-lGc05pGmveptO4oZoJq_L6XoTAIpxE8knTc6jxRmEQ,1680
+swarm/extensions/__init__.py,sha256=SadbzfxckByaaqzuKPfXMvqmj45-dcMlavlfQYhGnzE,56
+swarm/extensions/blueprint/__init__.py,sha256=-nAm6l7-42eAJYhWkQlcfq2hQB5ipxg2YIyiQRttX3c,1583
+swarm/extensions/blueprint/agent_utils.py,sha256=GLnjtLhtGW9k1vI9uqMojXcY-OkPXwdmQKLhs60CJ5k,1913
+swarm/extensions/blueprint/blueprint_base.py,sha256=hqvOQ3wS7OJNmqJgpH7IOjLTr3qyHf4XzXxqkkrGYzU,30478
+swarm/extensions/blueprint/blueprint_discovery.py,sha256=ihrIHo4mDaSAUVREXD1y26d5UmPnxVZtBwDGcDJeYrU,5139
+swarm/extensions/blueprint/blueprint_utils.py,sha256=Ef_pu-RYomqzFjMg6LOSPSdbYFCbYXjEoSvK1OT49Eo,702
+swarm/extensions/blueprint/common_utils.py,sha256=jeKcN3lMdrpOYWIpErH3L5am13jHjaImpVvk2b0mps4,462
+swarm/extensions/blueprint/django_utils.py,sha256=y3cGNXgCv4pqWFbVfLr3SmkKLAtwcJvf5JvoQphqAB0,10445
+swarm/extensions/blueprint/interactive_mode.py,sha256=EZaPKnbaw7aeexznI9mk2hEfgJROAljqo2o-ASFN0O4,4594
+swarm/extensions/blueprint/output_utils.py,sha256=ITsK3SgpPR3FVepOaq-P2MmSDIMtOTafepDRZHRt8cM,2883
+swarm/extensions/blueprint/spinner.py,sha256=3J0ZrNzoI5O5qR7hnCeRM3dZx2fLb_H3zkoj_AYt5LQ,3394
+swarm/extensions/blueprint/modes/rest_mode.py,sha256=KZuB_j2NfomER7CmlsLBqRipU3DymKY-9RpoGilMH0I,1357
+swarm/extensions/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+swarm/extensions/cli/blueprint_runner.py,sha256=CG6XfOiDWuc84I_qefBpkwxEs7JcIbvNJqce9jBYUxo,9158
+swarm/extensions/cli/cli_args.py,sha256=Lws6Q3I-DNpzq9qSRN8ylUXg-lWly1SuqDSQF9n50bw,2980
+swarm/extensions/cli/interactive_shell.py,sha256=ocHBP975uqJU5LQyM2IiMVW5lQ387lgYHe3sme9ucX4,1322
+swarm/extensions/cli/main.py,sha256=NnmovA7h1Rj1eDQVYe9AN6-eraIbIclHesNVmQPjdk4,1002
+swarm/extensions/cli/selection.py,sha256=etdG6hJFgnLuvD_sVJvXg8qFcgjzCjyL-vYyxWcU0TI,2002
+swarm/extensions/cli/utils.py,sha256=amDW-jbiM12N-t72j2S0cHP3Mxgoo3nrcwq6CwN9HFY,3290
+swarm/extensions/cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+swarm/extensions/cli/commands/blueprint_management.py,sha256=dLNLLoTjInXQ1m9zRyNxu8NacDgwqYY50GvnhSiMQ_I,1116
+swarm/extensions/cli/commands/config_management.py,sha256=RFu9AP437aqUnyy8RDoyoZgW0WfT7h88_CQJaUnCR9E,480
+swarm/extensions/cli/commands/edit_config.py,sha256=O2Y-BKOSx7shSc-kspyseEQvtIeyQBUCD7Aj3r9dirw,2325
+swarm/extensions/cli/commands/list_blueprints.py,sha256=TyZv_dqM_UTK84-s-Dp7UWUcvWHXsNuxnCRNNNymWio,768
+swarm/extensions/cli/commands/validate_env.py,sha256=VXBjx9etvj4Re8qLwIPoHr4g5VwbwBCBdsr8gGLLYHI,1958
+swarm/extensions/cli/commands/validate_envvars.py,sha256=7-BDPYzV7wsga7kOggHNuCscI-7z-oPjMEBhq-ndDXA,1588
+swarm/extensions/cli/utils/discover_commands.py,sha256=aJdU3kSmLlpBxzGdfOA88AaCwpknHSD2cE0piCHZRUY,1053
+swarm/extensions/cli/utils/env_setup.py,sha256=k7QxRjzIGx5HC6RVZP9QSaaXEKMkcKCewD66u0e7qfE,496
+swarm/extensions/config/__init__.py,sha256=WjmGxMU5k3S40TNQxTfByYcT2YAchq_5gzXFWDLrLzU,141
+swarm/extensions/config/config_loader.py,sha256=aOAx6Y3G49vGkRVS2CMX9tDyd-4drPa5cGzzIU8poUQ,21698
+swarm/extensions/config/config_manager.py,sha256=bBT-NGbRdsXoJ-lxZM5kjAf5FvVVGRVdbbCQJiCX1_0,9951
+swarm/extensions/config/server_config.py,sha256=iBlQOaFQmkEPNLmVpAQvXlSWhTsu-YMIjEf-H-7QfUU,1882
+swarm/extensions/config/setup_wizard.py,sha256=yAZ7MOgc8ZGti2kjZ72G6QLFBI0lbhXAa7Wi7SeXDYo,4567
+swarm/extensions/config/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+swarm/extensions/config/utils/logger.py,sha256=sUkKdZsjRiCGGCEPfZ4YqeZDbiaUeGFOa3mdbVOTmvU,1242
+swarm/extensions/launchers/__init__.py,sha256=RR4up00HKqXOOToxb63mKZ2o9fq-o75bUw7dZuxkAVk,56
+swarm/extensions/launchers/build_launchers.py,sha256=Eh3ODR9L4KinG1GDK4-lF3NE0EZ-ArCrP3fxtGYhXgs,433
+swarm/extensions/launchers/build_swarm_wrapper.py,sha256=c_9oR3To4M2cZyc1uYSiysHLhUGX5FkCAQk9AG7Va2Q,231
+swarm/extensions/launchers/swarm_api.py,sha256=f8olTI5JVdayp923etVQWsP8WRquPG5Mw3Q40ItN6kY,2877
+swarm/extensions/launchers/swarm_cli.py,sha256=ar0LxctmxUwhkVbKWLfGEcZB9c77qdPsf1Y33-UNgpY,14184
+swarm/extensions/launchers/swarm_wrapper.py,sha256=3K58yqPN4Ct0c7zfSDKRIGdL1Q7WOBXmAVHXT-aaPj4,1004
+swarm/extensions/mcp/__init__.py,sha256=Rn_lJsxmZZUJrzwig2M63lQxd7P_DX3fZyN1pJt2ps0,49
+swarm/extensions/mcp/cache_utils.py,sha256=i1-EUqJEwLyTZq-_EfIKLafD63_zpmn7gx5TNrFJEfM,952
+swarm/extensions/mcp/mcp_client.py,sha256=M6hOm1D9X8ROncgZe51KW9Bc9a1TfIWAaiJ5uNq8K6o,10972
+swarm/extensions/mcp/mcp_tool_provider.py,sha256=pE2LUJ-j_zC9dIpM3acQB9CxXDrbO74YMFlf_oD-3AI,5700
+swarm/extensions/mcp/mcp_utils.py,sha256=pmVTB7vttexMmMr4FpQbjpVG69Z7iCp7YYXOTaqUhJQ,14560
+swarm/llm/chat_completion.py,sha256=FREzS81pfn3EVg6kraWm8aGFltwLleYaC2MOzCOKBhE,7425
+swarm/migrations/0010_initial_chat_models.py,sha256=qJbvLReRBEOE08FkxjOWMcwu7Ny4epNI_eG1PF8wcWM,1900
+swarm/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+swarm/repl/__init__.py,sha256=hNU3HxjJJi6w5xgx34n3253QJPspFltrK7AM0G_1TlE,32
+swarm/repl/repl.py,sha256=sfVdSiDrStpZyxZehPn0nAxqaja2eySL9v9CfWhZEVc,2609
+swarm/utils/color_utils.py,sha256=utIfZ6ptGEdpHxIZiZ4gtfo5lLqZKQL5g0F8mEwMhTo,1184
+swarm/utils/context_utils.py,sha256=2Eu372CsuDTt6ikZ0w3OkLrFp4t9hKdgU5Kkc8faDDM,19315
+swarm/utils/general_utils.py,sha256=K3_Uy-189XSpLOxKGxl14fa2n7B0ZH28HgysL6vWG-M,7919
+swarm/utils/logger.py,sha256=g-ynqO3jqKx2rT2keiECsZ13aywFPsFlJAvo-SOeGlw,1679
+swarm/utils/logger_setup.py,sha256=2A9bXicV03yAPpgMFJGQt5ePB1tLwdkk7sCo-0OiglU,714
+swarm/utils/message_sequence.py,sha256=7Xa7YwGPgojfkrGcl-SbeR_BWwzXGDYNqAxq8F6XhDc,8616
+swarm/utils/message_utils.py,sha256=oNTD7pfmnnu_Br24pR2VEX9afIZwFLwg2HJBLXs1blY,4074
+swarm/utils/redact.py,sha256=L2lo927S575Ay7Jz6pUlK47Sxxzpd9IMybnDm6-WlC8,2955
+swarm/views/__init__.py,sha256=AcLk0R7Y69FhIVgJK2hZs8M_gCR-h_5iqUywz89yuHM,1223
+swarm/views/api_views.py,sha256=MXt_sWQYUIYgy6gTHSVIeSrszvhtkD-sxQiGBmdbQAg,1815
+swarm/views/chat_views.py,sha256=ch7q7yr-TcP0eoNcO4IhtsVGlhMGLUixBKtsb-Nr_6Q,4299
+swarm/views/core_views.py,sha256=VCv5BEBqUMz6OmQC4RkkIk1qq46f5f7Jyx4MqCaoENo,5229
+swarm/views/message_views.py,sha256=sDUnXyqKXC8WwIIMAlWf00s2_a2T9c75Na5FvYMJwBM,1596
+swarm/views/model_views.py,sha256=2bfqF8LOhgWDRFvm5FeovQDdLcZOS9OfkJLvSC0FDvs,6206
+swarm/views/utils.py,sha256=3EFpCe3sWeQDNnbReFJ-Xdv6KTX6kIMXg23wXQxary4,23678
+swarm/views/web_views.py,sha256=ExQQeJpZ8CkLZQC_pXKOOmdnEy2qR3wEBP4LLp27DPU,7404
+open_swarm-0.1.1748636295.dist-info/METADATA,sha256=_kFKA7JpUHOqO99Re3T7H8qdg4kt8eyq5HCDD6omJJs,11932
+open_swarm-0.1.1748636295.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+open_swarm-0.1.1748636295.dist-info/entry_points.txt,sha256=tHIcZBvy_sbp_nqZcLG3NSgElG6vEZcUvR5U5325qak,126
+open_swarm-0.1.1748636295.dist-info/top_level.txt,sha256=ETN-2phSZezexCGmKSre_aUhRK0XI9Rzz7Fw5TCsLsQ,6
+open_swarm-0.1.1748636295.dist-info/RECORD,,

{open_swarm-0.1.1745275181.dist-info → open_swarm-0.1.1748636295.dist-info}/WHEEL

@@ -1,4 +1,5 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
+

open_swarm-0.1.1748636295.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+swarm-api = swarm.extensions.launchers.swarm_api:main
+swarm-cli = swarm.extensions.launchers.swarm_cli:main

open_swarm-0.1.1748636295.dist-info/top_level.txt

@@ -0,0 +1 @@
+swarm

swarm/__init__.py

@@ -1 +1,3 @@
 default_app_config = 'swarm.apps.SwarmConfig'
+
+from .core import Swarm

swarm/agent/agent.py

@@ -0,0 +1,49 @@
+# src/swarm/agent/agent.py
+
+from typing import Callable, Dict, Any, List
+import json
+
+class Agent:
+    def __init__(self, name: str, instructions: str):
+        self.name = name
+        self.instructions = instructions
+        self.tools: Dict[str, Dict[str, Any]] = {}
+    
+    def register_tool(self, name: str, func: Callable[..., Any], description: str = ""):
+        """
+        Registers a tool with the agent.
+        
+        Args:
+            name (str): Name of the tool.
+            func (Callable[..., Any]): The function implementing the tool.
+            description (str): Description of the tool.
+        """
+        self.tools[name] = {
+            "func": func,
+            "description": description
+        }
+    
+    async def process(self, query: str) -> str:
+        """
+        Processes a user query by determining which tool to invoke.
+        
+        Args:
+            query (str): The user's query in JSON format specifying the tool and arguments.
+        
+        Returns:
+            str: The response from the tool execution.
+        """
+        try:
+            request = json.loads(query)
+            tool_name = request.get("tool")
+            arguments = request.get("arguments", {})
+            if tool_name in self.tools:
+                tool_func = self.tools[tool_name]["func"]
+                result = await tool_func(**arguments)
+                return result
+            else:
+                return f"Tool '{tool_name}' not found."
+        except json.JSONDecodeError:
+            return "Invalid query format. Expected JSON with 'tool' and 'arguments'."
+        except Exception as e:
+            return f"Error processing query: {e}"

swarm/auth.py

@@ -1,121 +1,56 @@
-import logging
 import os
-from rest_framework.authentication import BaseAuthentication, SessionAuthentication
-# Import BasePermission for creating custom permissions
-from rest_framework.permissions import BasePermission
-from rest_framework import exceptions
-from django.conf import settings
-from django.utils.translation import gettext_lazy as _
-# Import AnonymousUser
+import logging
 from django.contrib.auth.models import AnonymousUser
-# Keep get_user_model if CustomSessionAuthentication needs it or for future user mapping
-from django.contrib.auth import get_user_model
+from rest_framework.authentication import TokenAuthentication  # type: ignore
+from rest_framework.exceptions import AuthenticationFailed  # type: ignore
 
-logger = logging.getLogger('swarm.auth')
-User = get_user_model()
+logger = logging.getLogger(__name__)
 
-# ==============================================================================
-# Authentication Classes (Determine *who* the user is)
-# ==============================================================================
+class EnvAuthenticatedUser(AnonymousUser):
+    """ Custom user class that is always authenticated. """
+    @property
+    def is_authenticated(self) -> bool:  # type: ignore[override]
+        return True  # Ensure Django recognizes this user as authenticated
 
-# --- Static Token Authentication ---
-class StaticTokenAuthentication(BaseAuthentication):
+class EnvOrTokenAuthentication(TokenAuthentication):
     """
-    Authenticates requests based on a static API token passed in a header
-    (Authorization: Bearer <token> or X-API-Key: <token>).
-
-    Returns (AnonymousUser, token) on success. This allows permission classes
-    to check request.auth to see if token authentication succeeded, even though
-    no specific user model is associated with the token.
+    Custom authentication that allows:
+    1. If API_AUTH_TOKEN is set, it enforces token authentication.
+    2. Else if ENABLE_API_AUTH is False/Unset, authentication is bypassed.
+    3. Otherwise, falls back to Django's TokenAuthentication.
     """
-    keyword = 'Bearer'
-
     def authenticate(self, request):
-        """
-        Attempts to authenticate using a static token.
-        """
-        logger.debug("[Auth][StaticToken] Attempting static token authentication.")
-        # Retrieve the expected token from settings.
-        expected_token = getattr(settings, 'SWARM_API_KEY', None)
-
-        # If no token is configured in settings, this method cannot authenticate.
-        if not expected_token:
-            logger.error("[Auth][StaticToken] SWARM_API_KEY is not set in Django settings. Cannot use static token auth.")
-            return None # Indicate authentication method did not run or failed pre-check
-
-        # Extract the provided token from standard Authorization header or custom X-API-Key header.
-        provided_token = None
-        auth_header = request.META.get('HTTP_AUTHORIZATION', '').split()
-        if len(auth_header) == 2 and auth_header[0].lower() == self.keyword.lower():
-            provided_token = auth_header[1]
-            logger.debug("[Auth][StaticToken] Found token in Authorization header.")
-        else:
-            provided_token = request.META.get('HTTP_X_API_KEY')
-            if provided_token:
-                logger.debug("[Auth][StaticToken] Found token in X-API-Key header.")
-
-        # If no token was found in either header, authentication fails for this method.
-        if not provided_token:
-            logger.debug("[Auth][StaticToken] No token found in relevant headers.")
-            return None # Indicate authentication method did not find credentials
-
-        # Compare the provided token with the expected token.
-        # NOTE: For production, consider using a constant-time comparison function
-        #       to mitigate timing attacks if the token is highly sensitive.
-        if provided_token == expected_token:
-            logger.info("[Auth][StaticToken] Static token authentication successful.")
-            # Return AnonymousUser and the token itself as request.auth.
-            # This signals successful authentication via token without linking to a specific User model.
-            return (AnonymousUser(), provided_token)
-        else:
-            # Token was provided but did not match. Raise AuthenticationFailed.
-            logger.warning(f"[Auth][StaticToken] Invalid static token provided.")
-            raise exceptions.AuthenticationFailed(_("Invalid API Key."))
-
-# --- Custom *Synchronous* Session Authentication ---
-class CustomSessionAuthentication(SessionAuthentication):
-    """
-    Standard Django Session Authentication provided by DRF.
-    Relies on Django's session middleware to populate request.user.
-    This class itself is synchronous, but the underlying session loading
-    needs to be handled correctly in async views (e.g., via middleware or wrappers).
-    """
-    # No override needed unless customizing session behavior.
-    pass
-
-
-# ==============================================================================
-# Permission Classes (Determine *if* access is allowed)
-# ==============================================================================
-
-class HasValidTokenOrSession(BasePermission):
-    """
-    Allows access if EITHER:
-    1. Static token authentication succeeded (request.auth is not None).
-    2. Session authentication succeeded (request.user is authenticated).
-    """
-    message = 'Authentication credentials were not provided or are invalid (Requires valid API Key or active session).'
-
-    def has_permission(self, request, view):
-        """
-        Checks if the request has valid authentication via token or session.
-        """
-        # Check if static token authentication was successful.
-        # StaticTokenAuthentication returns (AnonymousUser, token), so request.auth will be the token.
-        has_valid_token = getattr(request, 'auth', None) is not None
-        if has_valid_token:
-            logger.debug("[Perm][TokenOrSession] Access granted via static token (request.auth is set).")
-            return True
-
-        # Check if session authentication was successful.
-        # request.user should be populated by SessionAuthentication/AuthMiddleware.
-        user = getattr(request, 'user', None)
-        has_valid_session = user is not None and user.is_authenticated
-        if has_valid_session:
-            logger.debug(f"[Perm][TokenOrSession] Access granted via authenticated session user: {user}")
-            return True
-
-        # If neither condition is met, deny permission.
-        logger.debug("[Perm][TokenOrSession] Access denied: No valid token (request.auth=None) and no authenticated session user.")
-        return False
-
+        auth_header = request.headers.get("Authorization", "")
+        env_token = os.getenv("API_AUTH_TOKEN", None)
+        enable_auth = os.getenv("ENABLE_API_AUTH", "false").lower() in ("true", "1", "t")
+
+        # If API authentication is disabled, allow unrestricted access
+        if not enable_auth:
+            logger.info("Authentication is disabled (ENABLE_API_AUTH not set or False). Allowing all users.")
+            return (EnvAuthenticatedUser(), None)
+
+        # If API_AUTH_TOKEN is set, enforce token validation
+        if env_token:
+            if not auth_header:
+                raise AuthenticationFailed("Authentication credentials were not provided.")
+            if not auth_header.startswith("Bearer "):
+                raise AuthenticationFailed("Invalid token format.")
+
+            token = auth_header.split("Bearer ")[-1].strip()
+
+            if token == env_token:
+                logger.info("Authenticated using API_AUTH_TOKEN.")
+                return (EnvAuthenticatedUser(), None)  # Allow access
+            else:
+                raise AuthenticationFailed("Invalid token.")
+
+        # If API authentication is disabled, allow unrestricted access
+        if not enable_auth:
+            logger.info("Authentication is disabled (ENABLE_API_AUTH not set or False). Allowing all users.")
+            return (EnvAuthenticatedUser(), None)
+
+        # Fallback to Django's TokenAuthentication
+        return super().authenticate(request)
+
+    def authenticate_header(self, request):
+        return "Bearer"

swarm/consumers.py

@@ -62,25 +62,6 @@ class DjangoChatConsumer(AsyncWebsocketConsumer):
         await self.send(text_data=system_message_html)
 
         client = AsyncOpenAI(api_key=os.getenv("OPENAI_API_KEY"))
-        
-        # --- PATCH: Enforce LiteLLM-only endpoint and suppress OpenAI tracing/telemetry ---
-        import os, logging
-        if os.environ.get("LITELLM_BASE_URL") or os.environ.get("OPENAI_BASE_URL"):
-            logging.getLogger("openai.agents").setLevel(logging.CRITICAL)
-            try:
-                import openai.agents.tracing
-                openai.agents.tracing.TracingClient = lambda *a, **kw: None
-            except Exception:
-                pass
-        def _enforce_litellm_only(client):
-            base_url = getattr(client, 'base_url', None)
-            if base_url and 'openai.com' in base_url:
-                return
-            if base_url and 'openai.com' not in base_url:
-                import traceback
-                raise RuntimeError(f"Attempted fallback to OpenAI API when custom base_url is set! base_url={base_url}\n{traceback.format_stack()}")
-        _enforce_litellm_only(client)
-        
         stream = await client.chat.completions.create(
             model=os.getenv("OPENAI_MODEL"),
             messages=self.messages,