Building AI agents, atomically
2025-04-25
Koichi KAWAMURAe359c8f78987
diff --git a/README.md b/README.mdindex 360cbc4..6bf0b91 100644--- a/README.md+++ b/README.md@@ -224,7 +224,7 @@ from atomic_agents.agents.base_agent import BaseIOSchema, BaseAgent, BaseAgentCofrom atomic_agents.lib.components.system_prompt_generator import SystemPromptGenerator# Import the search tool you want to use-from web_search_agent.tools.searxng_search import SearxNGSearchTool+from web_search_agent.tools.searxng_search import SearXNGSearchTool# Define the input schema for the query agentclass QueryAgentInputSchema(BaseIOSchema):@@ -233,7 +233,7 @@ class QueryAgentInputSchema(BaseIOSchema):num_queries: int = Field(..., description="Number of queries to generate.")# Initialize the query agent-query_agent = BaseAgent[QueryAgentInputSchema, SearxNGSearchTool.input_schema](+query_agent = BaseAgent[QueryAgentInputSchema, SearXNGSearchTool.input_schema](config=BaseAgentConfig(client=instructor.from_openai(openai.OpenAI()),model="gpt-4o-mini",@@ -257,7 +257,7 @@ query_agent = BaseAgent[QueryAgentInputSchema, SearxNGSearchTool.input_schema](In this example:-- **Modularity**: By setting the `output_schema` of the `query_agent` to match the `input_schema` of `SearxNGSearchTool`, you can directly use the output of the agent as input to the tool.+- **Modularity**: By setting the `output_schema` of the `query_agent` to match the `input_schema` of `SearXNGSearchTool`, you can directly use the output of the agent as input to the tool.- **Swapability**: If you decide to switch to a different search provider, you can import a different search tool and update the `output_schema` accordingly.For instance, to switch to another search service:@@ -318,7 +318,7 @@ API documentation can be found [here](https://brainblend-ai.github.io/atomic-ageAtomic Forge is a collection of tools that can be used with Atomic Agents to extend its functionality. Current tools include:- Calculator-- SearxNG Search+- SearXNG Search- YouTube Transcript ScraperFor more information on using and creating tools, see the [Atomic Forge README](/atomic-forge/README.md).diff --git a/atomic-examples/basic-multimodal/README.md b/atomic-examples/basic-multimodal/README.mdindex 38729c6..6066e77 100644--- a/atomic-examples/basic-multimodal/README.md+++ b/atomic-examples/basic-multimodal/README.md@@ -16,28 +16,34 @@ This example demonstrates how to use the Atomic Agents framework to analyze imag## Getting Started1. Clone the main Atomic Agents repository:+```bashgit clone https://github.com/BrainBlend-AI/atomic-agents```2. Navigate to the basic-multimodal directory:+```bashcd atomic-agents/atomic-examples/basic-multimodal```3. Install dependencies using Poetry:+```bashpoetry install```4. Set up environment variables:+Create a `.env` file in the `basic-multimodal` directory with the following content:```envOPENAI_API_KEY=your_openai_api_key```+Replace `your_openai_api_key` with your actual OpenAI API key.5. Run the example:+```bashpoetry run python basic_multimodal/main.py```@@ -45,18 +51,23 @@ This example demonstrates how to use the Atomic Agents framework to analyze imag## Components### 1. Nutrition Label Schema (`NutritionLabel`)+Defines the structure for storing nutrition information, including:+- Macronutrients (fats, proteins, carbohydrates)- Micronutrients (vitamins and minerals)- Serving information- Product details### 2. Input/Output Schemas+- `NutritionAnalysisInput`: Handles input images and analysis instructions- `NutritionAnalysisOutput`: Structures the extracted nutrition information### 3. Nutrition Analyzer Agent+A specialized agent configured with:+- GPT-4 Vision capabilities- Custom system prompts for nutrition label analysis- Structured data validation@@ -64,10 +75,12 @@ A specialized agent configured with:## Example UsageThe example includes test images in the `test_images` directory:+- `nutrition_label_1.png`: Example nutrition label image- `nutrition_label_2.jpg`: Another example nutrition label imageRunning the example will:+1. Load the test images2. Process them through the nutrition analyzer3. Display structured nutritional information for each label@@ -75,6 +88,7 @@ Running the example will:## CustomizationYou can modify the example by:+1. Adding your own nutrition label images to the `test_images` directory2. Adjusting the `NutritionLabel` schema to capture additional information3. Modifying the system prompt to focus on specific aspects of nutrition labelsdiff --git a/atomic-examples/basic-multimodal/poetry.lock b/atomic-examples/basic-multimodal/poetry.lockindex 82cf32a..5cb4e72 100644--- a/atomic-examples/basic-multimodal/poetry.lock+++ b/atomic-examples/basic-multimodal/poetry.lock@@ -1,4 +1,4 @@-# This file is automatically @generated by Poetry 2.0.0 and should not be changed by hand.+# This file is automatically @generated by Poetry 2.1.2 and should not be changed by hand.[[package]]name = "aiohappyeyeballs"@@ -108,7 +108,7 @@ propcache = ">=0.2.0"yarl = ">=1.17.0,<2.0"[package.extras]-speedups = ["Brotli", "aiodns (>=3.2.0)", "brotlicffi"]+speedups = ["Brotli ; platform_python_implementation == \"CPython\"", "aiodns (>=3.2.0) ; sys_platform == \"linux\" or sys_platform == \"darwin\"", "brotlicffi ; platform_python_implementation != \"CPython\""][[package]]name = "aiosignal"@@ -181,15 +181,15 @@ typing_extensions = {version = ">=4.5", markers = "python_version < \"3.13\""}[package.extras]doc = ["Sphinx (>=7.4,<8.0)", "packaging", "sphinx-autodoc-typehints (>=1.2.0)", "sphinx_rtd_theme"]-test = ["anyio[trio]", "coverage[toml] (>=7)", "exceptiongroup (>=1.2.0)", "hypothesis (>=4.0)", "psutil (>=5.9)", "pytest (>=7.0)", "pytest-mock (>=3.6.1)", "trustme", "truststore (>=0.9.1)", "uvloop (>=0.21)"]+test = ["anyio[trio]", "coverage[toml] (>=7)", "exceptiongroup (>=1.2.0)", "hypothesis (>=4.0)", "psutil (>=5.9)", "pytest (>=7.0)", "pytest-mock (>=3.6.1)", "trustme", "truststore (>=0.9.1) ; python_version >= \"3.10\"", "uvloop (>=0.21) ; platform_python_implementation == \"CPython\" and platform_system != \"Windows\""]trio = ["trio (>=0.26.1)"][[package]]name = "atomic-agents"-version = "1.0.16"+version = "1.1.0"description = "A versatile framework for creating and managing intelligent agents."optional = false-python-versions = ">=3.9,<4.0"+python-versions = ">=3.12,<4.0"groups = ["main"]files = []develop = true@@ -197,7 +197,8 @@ develop = true[package.dependencies]gitpython = ">=3.1.43,<4.0.0"instructor = ">=1.3.4,<2.0.0"-pydantic = ">=2.8.0,<3.0.0"+mcp = {version = "^1.6.0", extras = ["cli"]}+pydantic = "2.10.3"pyfiglet = ">=1.0.2,<2.0.0"pyyaml = ">=6.0.2,<7.0.0"requests = ">=2.32.3,<3.0.0"@@ -221,12 +222,12 @@ files = [][package.extras]-benchmark = ["cloudpickle", "hypothesis", "mypy (>=1.11.1)", "pympler", "pytest (>=4.3.0)", "pytest-codspeed", "pytest-mypy-plugins", "pytest-xdist[psutil]"]-cov = ["cloudpickle", "coverage[toml] (>=5.3)", "hypothesis", "mypy (>=1.11.1)", "pympler", "pytest (>=4.3.0)", "pytest-mypy-plugins", "pytest-xdist[psutil]"]-dev = ["cloudpickle", "hypothesis", "mypy (>=1.11.1)", "pre-commit-uv", "pympler", "pytest (>=4.3.0)", "pytest-mypy-plugins", "pytest-xdist[psutil]"]+benchmark = ["cloudpickle ; platform_python_implementation == \"CPython\"", "hypothesis", "mypy (>=1.11.1) ; platform_python_implementation == \"CPython\" and python_version >= \"3.10\"", "pympler", "pytest (>=4.3.0)", "pytest-codspeed", "pytest-mypy-plugins ; platform_python_implementation == \"CPython\" and python_version >= \"3.10\"", "pytest-xdist[psutil]"]+cov = ["cloudpickle ; platform_python_implementation == \"CPython\"", "coverage[toml] (>=5.3)", "hypothesis", "mypy (>=1.11.1) ; platform_python_implementation == \"CPython\" and python_version >= \"3.10\"", "pympler", "pytest (>=4.3.0)", "pytest-mypy-plugins ; platform_python_implementation == \"CPython\" and python_version >= \"3.10\"", "pytest-xdist[psutil]"]+dev = ["cloudpickle ; platform_python_implementation == \"CPython\"", "hypothesis", "mypy (>=1.11.1) ; platform_python_implementation == \"CPython\" and python_version >= \"3.10\"", "pre-commit-uv", "pympler", "pytest (>=4.3.0)", "pytest-mypy-plugins ; platform_python_implementation == \"CPython\" and python_version >= \"3.10\"", "pytest-xdist[psutil]"]docs = ["cogapp", "furo", "myst-parser", "sphinx", "sphinx-notfound-page", "sphinxcontrib-towncrier", "towncrier (<24.7)"]-tests = ["cloudpickle", "hypothesis", "mypy (>=1.11.1)", "pympler", "pytest (>=4.3.0)", "pytest-mypy-plugins", "pytest-xdist[psutil]"]-tests-mypy = ["mypy (>=1.11.1)", "pytest-mypy-plugins"]+tests = ["cloudpickle ; platform_python_implementation == \"CPython\"", "hypothesis", "mypy (>=1.11.1) ; platform_python_implementation == \"CPython\" and python_version >= \"3.10\"", "pympler", "pytest (>=4.3.0)", "pytest-mypy-plugins ; platform_python_implementation == \"CPython\" and python_version >= \"3.10\"", "pytest-xdist[psutil]"]+tests-mypy = ["mypy (>=1.11.1) ; platform_python_implementation == \"CPython\" and python_version >= \"3.10\"", "pytest-mypy-plugins ; platform_python_implementation == \"CPython\" and python_version >= \"3.10\""][[package]]name = "certifi"@@ -543,7 +544,7 @@ gitdb = ">=4.0.1,<5"[package.extras]doc = ["sphinx (==4.3.2)", "sphinx-autodoc-typehints", "sphinx-rtd-theme", "sphinxcontrib-applehelp (>=1.0.2,<=1.0.4)", "sphinxcontrib-devhelp (==1.0.2)", "sphinxcontrib-htmlhelp (>=2.0.0,<=2.0.1)", "sphinxcontrib-qthelp (==1.0.3)", "sphinxcontrib-serializinghtml (==1.1.5)"]-test = ["coverage[toml]", "ddt (>=1.1.1,!=1.4.3)", "mock", "mypy", "pre-commit", "pytest (>=7.3.1)", "pytest-cov", "pytest-instafail", "pytest-mock", "pytest-sugar", "typing-extensions"]+test = ["coverage[toml]", "ddt (>=1.1.1,!=1.4.3)", "mock ; python_version < \"3.8\"", "mypy", "pre-commit", "pytest (>=7.3.1)", "pytest-cov", "pytest-instafail", "pytest-mock", "pytest-sugar", "typing-extensions ; python_version < \"3.11\""][[package]]name = "groq"@@ -619,12 +620,24 @@ idna = "*"sniffio = "*"[package.extras]-brotli = ["brotli", "brotlicffi"]+brotli = ["brotli ; platform_python_implementation == \"CPython\"", "brotlicffi ; platform_python_implementation != \"CPython\""]cli = ["click (==8.*)", "pygments (==2.*)", "rich (>=10,<14)"]http2 = ["h2 (>=3,<5)"]socks = ["socksio (==1.*)"]zstd = ["zstandard (>=0.18.0)"]+[[package]]+name = "httpx-sse"+version = "0.4.0"+description = "Consume Server-Sent Event (SSE) messages with HTTPX."+optional = false+python-versions = ">=3.8"+groups = ["main"]+files = [+ {file = "httpx-sse-0.4.0.tar.gz", hash = "sha256:1e81a3a3070ce322add1d3529ed42eb5f70817f45ed6ec915ab753f961139721"},+ {file = "httpx_sse-0.4.0-py3-none-any.whl", hash = "sha256:f329af6eae57eaa2bdfd962b42524764af68075ea87370a2de920af5341e318f"},+]+[[package]]name = "idna"version = "3.10"@@ -913,6 +926,35 @@ files = [{file = "markupsafe-3.0.2.tar.gz", hash = "sha256:ee55d3edf80167e48ea11a923c7386f4669df67d7994554387f84e7d8b0a2bf0"},]+[[package]]+name = "mcp"+version = "1.6.0"+description = "Model Context Protocol SDK"+optional = false+python-versions = ">=3.10"+groups = ["main"]+files = [+ {file = "mcp-1.6.0-py3-none-any.whl", hash = "sha256:7bd24c6ea042dbec44c754f100984d186620d8b841ec30f1b19eda9b93a634d0"},+ {file = "mcp-1.6.0.tar.gz", hash = "sha256:d9324876de2c5637369f43161cd71eebfd803df5a95e46225cab8d280e366723"},+]++[package.dependencies]+anyio = ">=4.5"+httpx = ">=0.27"+httpx-sse = ">=0.4"+pydantic = ">=2.7.2,<3.0.0"+pydantic-settings = ">=2.5.2"+python-dotenv = {version = ">=1.0.0", optional = true, markers = "extra == \"cli\""}+sse-starlette = ">=1.6.1"+starlette = ">=0.27"+typer = {version = ">=0.12.4", optional = true, markers = "extra == \"cli\""}+uvicorn = ">=0.23.1"++[package.extras]+cli = ["python-dotenv (>=1.0.0)", "typer (>=0.12.4)"]+rich = ["rich (>=13.9.4)"]+ws = ["websockets (>=15.0.1)"]+[[package]]name = "mdit-py-plugins"version = "0.4.2"@@ -1219,138 +1261,162 @@ files = [[[package]]name = "pydantic"-version = "2.10.4"+version = "2.10.3"description = "Data validation using Python type hints"optional = falsepython-versions = ">=3.8"groups = ["main"]files = [- {file = "pydantic-2.10.4-py3-none-any.whl", hash = "sha256:597e135ea68be3a37552fb524bc7d0d66dcf93d395acd93a00682f1efcb8ee3d"},- {file = "pydantic-2.10.4.tar.gz", hash = "sha256:82f12e9723da6de4fe2ba888b5971157b3be7ad914267dea8f05f82b28254f06"},+ {file = "pydantic-2.10.3-py3-none-any.whl", hash = "sha256:be04d85bbc7b65651c5f8e6b9976ed9c6f41782a55524cef079a34a0bb82144d"},+ {file = "pydantic-2.10.3.tar.gz", hash = "sha256:cb5ac360ce894ceacd69c403187900a02c4b20b693a9dd1d643e1effab9eadf9"},][package.dependencies]annotated-types = ">=0.6.0"-pydantic-core = "2.27.2"+pydantic-core = "2.27.1"typing-extensions = ">=4.12.2"[package.extras]email = ["email-validator (>=2.0.0)"]-timezone = ["tzdata"]+timezone = ["tzdata ; python_version >= \"3.9\" and platform_system == \"Windows\""][[package]]name = "pydantic-core"-version = "2.27.2"+version = "2.27.1"description = "Core functionality for Pydantic validation and serialization"optional = falsepython-versions = ">=3.8"groups = ["main"]files = [- {file = "pydantic_core-2.27.2-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:2d367ca20b2f14095a8f4fa1210f5a7b78b8a20009ecced6b12818f455b1e9fa"},- {file = "pydantic_core-2.27.2-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:491a2b73db93fab69731eaee494f320faa4e093dbed776be1a829c2eb222c34c"},- {file = "pydantic_core-2.27.2-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7969e133a6f183be60e9f6f56bfae753585680f3b7307a8e555a948d443cc05a"},- {file = "pydantic_core-2.27.2-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:3de9961f2a346257caf0aa508a4da705467f53778e9ef6fe744c038119737ef5"},- {file = "pydantic_core-2.27.2-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e2bb4d3e5873c37bb3dd58714d4cd0b0e6238cebc4177ac8fe878f8b3aa8e74c"},- {file = "pydantic_core-2.27.2-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:280d219beebb0752699480fe8f1dc61ab6615c2046d76b7ab7ee38858de0a4e7"},- {file = "pydantic_core-2.27.2-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47956ae78b6422cbd46f772f1746799cbb862de838fd8d1fbd34a82e05b0983a"},- {file = "pydantic_core-2.27.2-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:14d4a5c49d2f009d62a2a7140d3064f686d17a5d1a268bc641954ba181880236"},- {file = "pydantic_core-2.27.2-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:337b443af21d488716f8d0b6164de833e788aa6bd7e3a39c005febc1284f4962"},- {file = "pydantic_core-2.27.2-cp310-cp310-musllinux_1_1_armv7l.whl", hash = "sha256:03d0f86ea3184a12f41a2d23f7ccb79cdb5a18e06993f8a45baa8dfec746f0e9"},- {file = "pydantic_core-2.27.2-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:7041c36f5680c6e0f08d922aed302e98b3745d97fe1589db0a3eebf6624523af"},- {file = "pydantic_core-2.27.2-cp310-cp310-win32.whl", hash = "sha256:50a68f3e3819077be2c98110c1f9dcb3817e93f267ba80a2c05bb4f8799e2ff4"},- {file = "pydantic_core-2.27.2-cp310-cp310-win_amd64.whl", hash = "sha256:e0fd26b16394ead34a424eecf8a31a1f5137094cabe84a1bcb10fa6ba39d3d31"},- {file = "pydantic_core-2.27.2-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:8e10c99ef58cfdf2a66fc15d66b16c4a04f62bca39db589ae8cba08bc55331bc"},- {file = "pydantic_core-2.27.2-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:26f32e0adf166a84d0cb63be85c562ca8a6fa8de28e5f0d92250c6b7e9e2aff7"},- {file = "pydantic_core-2.27.2-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8c19d1ea0673cd13cc2f872f6c9ab42acc4e4f492a7ca9d3795ce2b112dd7e15"},- {file = "pydantic_core-2.27.2-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5e68c4446fe0810e959cdff46ab0a41ce2f2c86d227d96dc3847af0ba7def306"},- {file = "pydantic_core-2.27.2-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:d9640b0059ff4f14d1f37321b94061c6db164fbe49b334b31643e0528d100d99"},- {file = "pydantic_core-2.27.2-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:40d02e7d45c9f8af700f3452f329ead92da4c5f4317ca9b896de7ce7199ea459"},- {file = "pydantic_core-2.27.2-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:1c1fd185014191700554795c99b347d64f2bb637966c4cfc16998a0ca700d048"},- {file = "pydantic_core-2.27.2-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d81d2068e1c1228a565af076598f9e7451712700b673de8f502f0334f281387d"},- {file = "pydantic_core-2.27.2-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:1a4207639fb02ec2dbb76227d7c751a20b1a6b4bc52850568e52260cae64ca3b"},- {file = "pydantic_core-2.27.2-cp311-cp311-musllinux_1_1_armv7l.whl", hash = "sha256:3de3ce3c9ddc8bbd88f6e0e304dea0e66d843ec9de1b0042b0911c1663ffd474"},- {file = "pydantic_core-2.27.2-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:30c5f68ded0c36466acede341551106821043e9afaad516adfb6e8fa80a4e6a6"},- {file = "pydantic_core-2.27.2-cp311-cp311-win32.whl", hash = "sha256:c70c26d2c99f78b125a3459f8afe1aed4d9687c24fd677c6a4436bc042e50d6c"},- {file = "pydantic_core-2.27.2-cp311-cp311-win_amd64.whl", hash = "sha256:08e125dbdc505fa69ca7d9c499639ab6407cfa909214d500897d02afb816e7cc"},- {file = "pydantic_core-2.27.2-cp311-cp311-win_arm64.whl", hash = "sha256:26f0d68d4b235a2bae0c3fc585c585b4ecc51382db0e3ba402a22cbc440915e4"},- {file = "pydantic_core-2.27.2-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:9e0c8cfefa0ef83b4da9588448b6d8d2a2bf1a53c3f1ae5fca39eb3061e2f0b0"},- {file = "pydantic_core-2.27.2-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:83097677b8e3bd7eaa6775720ec8e0405f1575015a463285a92bfdfe254529ef"},- {file = "pydantic_core-2.27.2-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:172fce187655fece0c90d90a678424b013f8fbb0ca8b036ac266749c09438cb7"},- {file = "pydantic_core-2.27.2-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:519f29f5213271eeeeb3093f662ba2fd512b91c5f188f3bb7b27bc5973816934"},- {file = "pydantic_core-2.27.2-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:05e3a55d124407fffba0dd6b0c0cd056d10e983ceb4e5dbd10dda135c31071d6"},- {file = "pydantic_core-2.27.2-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:9c3ed807c7b91de05e63930188f19e921d1fe90de6b4f5cd43ee7fcc3525cb8c"},- {file = "pydantic_core-2.27.2-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6fb4aadc0b9a0c063206846d603b92030eb6f03069151a625667f982887153e2"},- {file = "pydantic_core-2.27.2-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:28ccb213807e037460326424ceb8b5245acb88f32f3d2777427476e1b32c48c4"},- {file = "pydantic_core-2.27.2-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:de3cd1899e2c279b140adde9357c4495ed9d47131b4a4eaff9052f23398076b3"},- {file = "pydantic_core-2.27.2-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:220f892729375e2d736b97d0e51466252ad84c51857d4d15f5e9692f9ef12be4"},- {file = "pydantic_core-2.27.2-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:a0fcd29cd6b4e74fe8ddd2c90330fd8edf2e30cb52acda47f06dd615ae72da57"},- {file = "pydantic_core-2.27.2-cp312-cp312-win32.whl", hash = "sha256:1e2cb691ed9834cd6a8be61228471d0a503731abfb42f82458ff27be7b2186fc"},- {file = "pydantic_core-2.27.2-cp312-cp312-win_amd64.whl", hash = "sha256:cc3f1a99a4f4f9dd1de4fe0312c114e740b5ddead65bb4102884b384c15d8bc9"},- {file = "pydantic_core-2.27.2-cp312-cp312-win_arm64.whl", hash = "sha256:3911ac9284cd8a1792d3cb26a2da18f3ca26c6908cc434a18f730dc0db7bfa3b"},- {file = "pydantic_core-2.27.2-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:7d14bd329640e63852364c306f4d23eb744e0f8193148d4044dd3dacdaacbd8b"},- {file = "pydantic_core-2.27.2-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:82f91663004eb8ed30ff478d77c4d1179b3563df6cdb15c0817cd1cdaf34d154"},- {file = "pydantic_core-2.27.2-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:71b24c7d61131bb83df10cc7e687433609963a944ccf45190cfc21e0887b08c9"},- {file = "pydantic_core-2.27.2-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:fa8e459d4954f608fa26116118bb67f56b93b209c39b008277ace29937453dc9"},- {file = "pydantic_core-2.27.2-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:ce8918cbebc8da707ba805b7fd0b382816858728ae7fe19a942080c24e5b7cd1"},- {file = "pydantic_core-2.27.2-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:eda3f5c2a021bbc5d976107bb302e0131351c2ba54343f8a496dc8783d3d3a6a"},- {file = "pydantic_core-2.27.2-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bd8086fa684c4775c27f03f062cbb9eaa6e17f064307e86b21b9e0abc9c0f02e"},- {file = "pydantic_core-2.27.2-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:8d9b3388db186ba0c099a6d20f0604a44eabdeef1777ddd94786cdae158729e4"},- {file = "pydantic_core-2.27.2-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:7a66efda2387de898c8f38c0cf7f14fca0b51a8ef0b24bfea5849f1b3c95af27"},- {file = "pydantic_core-2.27.2-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:18a101c168e4e092ab40dbc2503bdc0f62010e95d292b27827871dc85450d7ee"},- {file = "pydantic_core-2.27.2-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:ba5dd002f88b78a4215ed2f8ddbdf85e8513382820ba15ad5ad8955ce0ca19a1"},- {file = "pydantic_core-2.27.2-cp313-cp313-win32.whl", hash = "sha256:1ebaf1d0481914d004a573394f4be3a7616334be70261007e47c2a6fe7e50130"},- {file = "pydantic_core-2.27.2-cp313-cp313-win_amd64.whl", hash = "sha256:953101387ecf2f5652883208769a79e48db18c6df442568a0b5ccd8c2723abee"},- {file = "pydantic_core-2.27.2-cp313-cp313-win_arm64.whl", hash = "sha256:ac4dbfd1691affb8f48c2c13241a2e3b60ff23247cbcf981759c768b6633cf8b"},- {file = "pydantic_core-2.27.2-cp38-cp38-macosx_10_12_x86_64.whl", hash = "sha256:d3e8d504bdd3f10835468f29008d72fc8359d95c9c415ce6e767203db6127506"},- {file = "pydantic_core-2.27.2-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:521eb9b7f036c9b6187f0b47318ab0d7ca14bd87f776240b90b21c1f4f149320"},- {file = "pydantic_core-2.27.2-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:85210c4d99a0114f5a9481b44560d7d1e35e32cc5634c656bc48e590b669b145"},- {file = "pydantic_core-2.27.2-cp38-cp38-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:d716e2e30c6f140d7560ef1538953a5cd1a87264c737643d481f2779fc247fe1"},- {file = "pydantic_core-2.27.2-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f66d89ba397d92f840f8654756196d93804278457b5fbede59598a1f9f90b228"},- {file = "pydantic_core-2.27.2-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:669e193c1c576a58f132e3158f9dfa9662969edb1a250c54d8fa52590045f046"},- {file = "pydantic_core-2.27.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9fdbe7629b996647b99c01b37f11170a57ae675375b14b8c13b8518b8320ced5"},- {file = "pydantic_core-2.27.2-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d262606bf386a5ba0b0af3b97f37c83d7011439e3dc1a9298f21efb292e42f1a"},- {file = "pydantic_core-2.27.2-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:cabb9bcb7e0d97f74df8646f34fc76fbf793b7f6dc2438517d7a9e50eee4f14d"},- {file = "pydantic_core-2.27.2-cp38-cp38-musllinux_1_1_armv7l.whl", hash = "sha256:d2d63f1215638d28221f664596b1ccb3944f6e25dd18cd3b86b0a4c408d5ebb9"},- {file = "pydantic_core-2.27.2-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:bca101c00bff0adb45a833f8451b9105d9df18accb8743b08107d7ada14bd7da"},- {file = "pydantic_core-2.27.2-cp38-cp38-win32.whl", hash = "sha256:f6f8e111843bbb0dee4cb6594cdc73e79b3329b526037ec242a3e49012495b3b"},- {file = "pydantic_core-2.27.2-cp38-cp38-win_amd64.whl", hash = "sha256:fd1aea04935a508f62e0d0ef1f5ae968774a32afc306fb8545e06f5ff5cdf3ad"},- {file = "pydantic_core-2.27.2-cp39-cp39-macosx_10_12_x86_64.whl", hash = "sha256:c10eb4f1659290b523af58fa7cffb452a61ad6ae5613404519aee4bfbf1df993"},- {file = "pydantic_core-2.27.2-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:ef592d4bad47296fb11f96cd7dc898b92e795032b4894dfb4076cfccd43a9308"},- {file = "pydantic_core-2.27.2-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c61709a844acc6bf0b7dce7daae75195a10aac96a596ea1b776996414791ede4"},- {file = "pydantic_core-2.27.2-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:42c5f762659e47fdb7b16956c71598292f60a03aa92f8b6351504359dbdba6cf"},- {file = "pydantic_core-2.27.2-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4c9775e339e42e79ec99c441d9730fccf07414af63eac2f0e48e08fd38a64d76"},- {file = "pydantic_core-2.27.2-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:57762139821c31847cfb2df63c12f725788bd9f04bc2fb392790959b8f70f118"},- {file = "pydantic_core-2.27.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0d1e85068e818c73e048fe28cfc769040bb1f475524f4745a5dc621f75ac7630"},- {file = "pydantic_core-2.27.2-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:097830ed52fd9e427942ff3b9bc17fab52913b2f50f2880dc4a5611446606a54"},- {file = "pydantic_core-2.27.2-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:044a50963a614ecfae59bb1eaf7ea7efc4bc62f49ed594e18fa1e5d953c40e9f"},- {file = "pydantic_core-2.27.2-cp39-cp39-musllinux_1_1_armv7l.whl", hash = "sha256:4e0b4220ba5b40d727c7f879eac379b822eee5d8fff418e9d3381ee45b3b0362"},- {file = "pydantic_core-2.27.2-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:5e4f4bb20d75e9325cc9696c6802657b58bc1dbbe3022f32cc2b2b632c3fbb96"},- {file = "pydantic_core-2.27.2-cp39-cp39-win32.whl", hash = "sha256:cca63613e90d001b9f2f9a9ceb276c308bfa2a43fafb75c8031c4f66039e8c6e"},- {file = "pydantic_core-2.27.2-cp39-cp39-win_amd64.whl", hash = "sha256:77d1bca19b0f7021b3a982e6f903dcd5b2b06076def36a652e3907f596e29f67"},- {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:2bf14caea37e91198329b828eae1618c068dfb8ef17bb33287a7ad4b61ac314e"},- {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:b0cb791f5b45307caae8810c2023a184c74605ec3bcbb67d13846c28ff731ff8"},- {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:688d3fd9fcb71f41c4c015c023d12a79d1c4c0732ec9eb35d96e3388a120dcf3"},- {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:3d591580c34f4d731592f0e9fe40f9cc1b430d297eecc70b962e93c5c668f15f"},- {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:82f986faf4e644ffc189a7f1aafc86e46ef70372bb153e7001e8afccc6e54133"},- {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:bec317a27290e2537f922639cafd54990551725fc844249e64c523301d0822fc"},- {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:0296abcb83a797db256b773f45773da397da75a08f5fcaef41f2044adec05f50"},- {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:0d75070718e369e452075a6017fbf187f788e17ed67a3abd47fa934d001863d9"},- {file = "pydantic_core-2.27.2-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:7e17b560be3c98a8e3aa66ce828bdebb9e9ac6ad5466fba92eb74c4c95cb1151"},- {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-macosx_10_12_x86_64.whl", hash = "sha256:c33939a82924da9ed65dab5a65d427205a73181d8098e79b6b426bdf8ad4e656"},- {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-macosx_11_0_arm64.whl", hash = "sha256:00bad2484fa6bda1e216e7345a798bd37c68fb2d97558edd584942aa41b7d278"},- {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c817e2b40aba42bac6f457498dacabc568c3b7a986fc9ba7c8d9d260b71485fb"},- {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:251136cdad0cb722e93732cb45ca5299fb56e1344a833640bf93b2803f8d1bfd"},- {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d2088237af596f0a524d3afc39ab3b036e8adb054ee57cbb1dcf8e09da5b29cc"},- {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:d4041c0b966a84b4ae7a09832eb691a35aec90910cd2dbe7a208de59be77965b"},- {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:8083d4e875ebe0b864ffef72a4304827015cff328a1be6e22cc850753bfb122b"},- {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:f141ee28a0ad2123b6611b6ceff018039df17f32ada8b534e6aa039545a3efb2"},- {file = "pydantic_core-2.27.2-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:7d0c8399fcc1848491f00e0314bd59fb34a9c008761bcb422a057670c3f65e35"},- {file = "pydantic_core-2.27.2.tar.gz", hash = "sha256:eb026e5a4c1fee05726072337ff51d1efb6f59090b7da90d30ea58625b1ffb39"},+ {file = "pydantic_core-2.27.1-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:71a5e35c75c021aaf400ac048dacc855f000bdfed91614b4a726f7432f1f3d6a"},+ {file = "pydantic_core-2.27.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:f82d068a2d6ecfc6e054726080af69a6764a10015467d7d7b9f66d6ed5afa23b"},+ {file = "pydantic_core-2.27.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:121ceb0e822f79163dd4699e4c54f5ad38b157084d97b34de8b232bcaad70278"},+ {file = "pydantic_core-2.27.1-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:4603137322c18eaf2e06a4495f426aa8d8388940f3c457e7548145011bb68e05"},+ {file = "pydantic_core-2.27.1-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a33cd6ad9017bbeaa9ed78a2e0752c5e250eafb9534f308e7a5f7849b0b1bfb4"},+ {file = "pydantic_core-2.27.1-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:15cc53a3179ba0fcefe1e3ae50beb2784dede4003ad2dfd24f81bba4b23a454f"},+ {file = "pydantic_core-2.27.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:45d9c5eb9273aa50999ad6adc6be5e0ecea7e09dbd0d31bd0c65a55a2592ca08"},+ {file = "pydantic_core-2.27.1-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:8bf7b66ce12a2ac52d16f776b31d16d91033150266eb796967a7e4621707e4f6"},+ {file = "pydantic_core-2.27.1-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:655d7dd86f26cb15ce8a431036f66ce0318648f8853d709b4167786ec2fa4807"},+ {file = "pydantic_core-2.27.1-cp310-cp310-musllinux_1_1_armv7l.whl", hash = "sha256:5556470f1a2157031e676f776c2bc20acd34c1990ca5f7e56f1ebf938b9ab57c"},+ {file = "pydantic_core-2.27.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:f69ed81ab24d5a3bd93861c8c4436f54afdf8e8cc421562b0c7504cf3be58206"},+ {file = "pydantic_core-2.27.1-cp310-none-win32.whl", hash = "sha256:f5a823165e6d04ccea61a9f0576f345f8ce40ed533013580e087bd4d7442b52c"},+ {file = "pydantic_core-2.27.1-cp310-none-win_amd64.whl", hash = "sha256:57866a76e0b3823e0b56692d1a0bf722bffb324839bb5b7226a7dbd6c9a40b17"},+ {file = "pydantic_core-2.27.1-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:ac3b20653bdbe160febbea8aa6c079d3df19310d50ac314911ed8cc4eb7f8cb8"},+ {file = "pydantic_core-2.27.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:a5a8e19d7c707c4cadb8c18f5f60c843052ae83c20fa7d44f41594c644a1d330"},+ {file = "pydantic_core-2.27.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7f7059ca8d64fea7f238994c97d91f75965216bcbe5f695bb44f354893f11d52"},+ {file = "pydantic_core-2.27.1-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:bed0f8a0eeea9fb72937ba118f9db0cb7e90773462af7962d382445f3005e5a4"},+ {file = "pydantic_core-2.27.1-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a3cb37038123447cf0f3ea4c74751f6a9d7afef0eb71aa07bf5f652b5e6a132c"},+ {file = "pydantic_core-2.27.1-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:84286494f6c5d05243456e04223d5a9417d7f443c3b76065e75001beb26f88de"},+ {file = "pydantic_core-2.27.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:acc07b2cfc5b835444b44a9956846b578d27beeacd4b52e45489e93276241025"},+ {file = "pydantic_core-2.27.1-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4fefee876e07a6e9aad7a8c8c9f85b0cdbe7df52b8a9552307b09050f7512c7e"},+ {file = "pydantic_core-2.27.1-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:258c57abf1188926c774a4c94dd29237e77eda19462e5bb901d88adcab6af919"},+ {file = "pydantic_core-2.27.1-cp311-cp311-musllinux_1_1_armv7l.whl", hash = "sha256:35c14ac45fcfdf7167ca76cc80b2001205a8d5d16d80524e13508371fb8cdd9c"},+ {file = "pydantic_core-2.27.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:d1b26e1dff225c31897696cab7d4f0a315d4c0d9e8666dbffdb28216f3b17fdc"},+ {file = "pydantic_core-2.27.1-cp311-none-win32.whl", hash = "sha256:2cdf7d86886bc6982354862204ae3b2f7f96f21a3eb0ba5ca0ac42c7b38598b9"},+ {file = "pydantic_core-2.27.1-cp311-none-win_amd64.whl", hash = "sha256:3af385b0cee8df3746c3f406f38bcbfdc9041b5c2d5ce3e5fc6637256e60bbc5"},+ {file = "pydantic_core-2.27.1-cp311-none-win_arm64.whl", hash = "sha256:81f2ec23ddc1b476ff96563f2e8d723830b06dceae348ce02914a37cb4e74b89"},+ {file = "pydantic_core-2.27.1-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:9cbd94fc661d2bab2bc702cddd2d3370bbdcc4cd0f8f57488a81bcce90c7a54f"},+ {file = "pydantic_core-2.27.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:5f8c4718cd44ec1580e180cb739713ecda2bdee1341084c1467802a417fe0f02"},+ {file = "pydantic_core-2.27.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:15aae984e46de8d376df515f00450d1522077254ef6b7ce189b38ecee7c9677c"},+ {file = "pydantic_core-2.27.1-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:1ba5e3963344ff25fc8c40da90f44b0afca8cfd89d12964feb79ac1411a260ac"},+ {file = "pydantic_core-2.27.1-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:992cea5f4f3b29d6b4f7f1726ed8ee46c8331c6b4eed6db5b40134c6fe1768bb"},+ {file = "pydantic_core-2.27.1-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:0325336f348dbee6550d129b1627cb8f5351a9dc91aad141ffb96d4937bd9529"},+ {file = "pydantic_core-2.27.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7597c07fbd11515f654d6ece3d0e4e5093edc30a436c63142d9a4b8e22f19c35"},+ {file = "pydantic_core-2.27.1-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:3bbd5d8cc692616d5ef6fbbbd50dbec142c7e6ad9beb66b78a96e9c16729b089"},+ {file = "pydantic_core-2.27.1-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:dc61505e73298a84a2f317255fcc72b710b72980f3a1f670447a21efc88f8381"},+ {file = "pydantic_core-2.27.1-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:e1f735dc43da318cad19b4173dd1ffce1d84aafd6c9b782b3abc04a0d5a6f5bb"},+ {file = "pydantic_core-2.27.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:f4e5658dbffe8843a0f12366a4c2d1c316dbe09bb4dfbdc9d2d9cd6031de8aae"},+ {file = "pydantic_core-2.27.1-cp312-none-win32.whl", hash = "sha256:672ebbe820bb37988c4d136eca2652ee114992d5d41c7e4858cdd90ea94ffe5c"},+ {file = "pydantic_core-2.27.1-cp312-none-win_amd64.whl", hash = "sha256:66ff044fd0bb1768688aecbe28b6190f6e799349221fb0de0e6f4048eca14c16"},+ {file = "pydantic_core-2.27.1-cp312-none-win_arm64.whl", hash = "sha256:9a3b0793b1bbfd4146304e23d90045f2a9b5fd5823aa682665fbdaf2a6c28f3e"},+ {file = "pydantic_core-2.27.1-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:f216dbce0e60e4d03e0c4353c7023b202d95cbaeff12e5fd2e82ea0a66905073"},+ {file = "pydantic_core-2.27.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:a2e02889071850bbfd36b56fd6bc98945e23670773bc7a76657e90e6b6603c08"},+ {file = "pydantic_core-2.27.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:42b0e23f119b2b456d07ca91b307ae167cc3f6c846a7b169fca5326e32fdc6cf"},+ {file = "pydantic_core-2.27.1-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:764be71193f87d460a03f1f7385a82e226639732214b402f9aa61f0d025f0737"},+ {file = "pydantic_core-2.27.1-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1c00666a3bd2f84920a4e94434f5974d7bbc57e461318d6bb34ce9cdbbc1f6b2"},+ {file = "pydantic_core-2.27.1-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3ccaa88b24eebc0f849ce0a4d09e8a408ec5a94afff395eb69baf868f5183107"},+ {file = "pydantic_core-2.27.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:c65af9088ac534313e1963443d0ec360bb2b9cba6c2909478d22c2e363d98a51"},+ {file = "pydantic_core-2.27.1-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:206b5cf6f0c513baffaeae7bd817717140770c74528f3e4c3e1cec7871ddd61a"},+ {file = "pydantic_core-2.27.1-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:062f60e512fc7fff8b8a9d680ff0ddaaef0193dba9fa83e679c0c5f5fbd018bc"},+ {file = "pydantic_core-2.27.1-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:a0697803ed7d4af5e4c1adf1670af078f8fcab7a86350e969f454daf598c4960"},+ {file = "pydantic_core-2.27.1-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:58ca98a950171f3151c603aeea9303ef6c235f692fe555e883591103da709b23"},+ {file = "pydantic_core-2.27.1-cp313-none-win32.whl", hash = "sha256:8065914ff79f7eab1599bd80406681f0ad08f8e47c880f17b416c9f8f7a26d05"},+ {file = "pydantic_core-2.27.1-cp313-none-win_amd64.whl", hash = "sha256:ba630d5e3db74c79300d9a5bdaaf6200172b107f263c98a0539eeecb857b2337"},+ {file = "pydantic_core-2.27.1-cp313-none-win_arm64.whl", hash = "sha256:45cf8588c066860b623cd11c4ba687f8d7175d5f7ef65f7129df8a394c502de5"},+ {file = "pydantic_core-2.27.1-cp38-cp38-macosx_10_12_x86_64.whl", hash = "sha256:5897bec80a09b4084aee23f9b73a9477a46c3304ad1d2d07acca19723fb1de62"},+ {file = "pydantic_core-2.27.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:d0165ab2914379bd56908c02294ed8405c252250668ebcb438a55494c69f44ab"},+ {file = "pydantic_core-2.27.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6b9af86e1d8e4cfc82c2022bfaa6f459381a50b94a29e95dcdda8442d6d83864"},+ {file = "pydantic_core-2.27.1-cp38-cp38-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5f6c8a66741c5f5447e047ab0ba7a1c61d1e95580d64bce852e3df1f895c4067"},+ {file = "pydantic_core-2.27.1-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9a42d6a8156ff78981f8aa56eb6394114e0dedb217cf8b729f438f643608cbcd"},+ {file = "pydantic_core-2.27.1-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:64c65f40b4cd8b0e049a8edde07e38b476da7e3aaebe63287c899d2cff253fa5"},+ {file = "pydantic_core-2.27.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9fdcf339322a3fae5cbd504edcefddd5a50d9ee00d968696846f089b4432cf78"},+ {file = "pydantic_core-2.27.1-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:bf99c8404f008750c846cb4ac4667b798a9f7de673ff719d705d9b2d6de49c5f"},+ {file = "pydantic_core-2.27.1-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:8f1edcea27918d748c7e5e4d917297b2a0ab80cad10f86631e488b7cddf76a36"},+ {file = "pydantic_core-2.27.1-cp38-cp38-musllinux_1_1_armv7l.whl", hash = "sha256:159cac0a3d096f79ab6a44d77a961917219707e2a130739c64d4dd46281f5c2a"},+ {file = "pydantic_core-2.27.1-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:029d9757eb621cc6e1848fa0b0310310de7301057f623985698ed7ebb014391b"},+ {file = "pydantic_core-2.27.1-cp38-none-win32.whl", hash = "sha256:a28af0695a45f7060e6f9b7092558a928a28553366519f64083c63a44f70e618"},+ {file = "pydantic_core-2.27.1-cp38-none-win_amd64.whl", hash = "sha256:2d4567c850905d5eaaed2f7a404e61012a51caf288292e016360aa2b96ff38d4"},+ {file = "pydantic_core-2.27.1-cp39-cp39-macosx_10_12_x86_64.whl", hash = "sha256:e9386266798d64eeb19dd3677051f5705bf873e98e15897ddb7d76f477131967"},+ {file = "pydantic_core-2.27.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:4228b5b646caa73f119b1ae756216b59cc6e2267201c27d3912b592c5e323b60"},+ {file = "pydantic_core-2.27.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0b3dfe500de26c52abe0477dde16192ac39c98f05bf2d80e76102d394bd13854"},+ {file = "pydantic_core-2.27.1-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:aee66be87825cdf72ac64cb03ad4c15ffef4143dbf5c113f64a5ff4f81477bf9"},+ {file = "pydantic_core-2.27.1-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3b748c44bb9f53031c8cbc99a8a061bc181c1000c60a30f55393b6e9c45cc5bd"},+ {file = "pydantic_core-2.27.1-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:5ca038c7f6a0afd0b2448941b6ef9d5e1949e999f9e5517692eb6da58e9d44be"},+ {file = "pydantic_core-2.27.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6e0bd57539da59a3e4671b90a502da9a28c72322a4f17866ba3ac63a82c4498e"},+ {file = "pydantic_core-2.27.1-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:ac6c2c45c847bbf8f91930d88716a0fb924b51e0c6dad329b793d670ec5db792"},+ {file = "pydantic_core-2.27.1-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:b94d4ba43739bbe8b0ce4262bcc3b7b9f31459ad120fb595627eaeb7f9b9ca01"},+ {file = "pydantic_core-2.27.1-cp39-cp39-musllinux_1_1_armv7l.whl", hash = "sha256:00e6424f4b26fe82d44577b4c842d7df97c20be6439e8e685d0d715feceb9fb9"},+ {file = "pydantic_core-2.27.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:38de0a70160dd97540335b7ad3a74571b24f1dc3ed33f815f0880682e6880131"},+ {file = "pydantic_core-2.27.1-cp39-none-win32.whl", hash = "sha256:7ccebf51efc61634f6c2344da73e366c75e735960b5654b63d7e6f69a5885fa3"},+ {file = "pydantic_core-2.27.1-cp39-none-win_amd64.whl", hash = "sha256:a57847b090d7892f123726202b7daa20df6694cbd583b67a592e856bff603d6c"},+ {file = "pydantic_core-2.27.1-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:3fa80ac2bd5856580e242dbc202db873c60a01b20309c8319b5c5986fbe53ce6"},+ {file = "pydantic_core-2.27.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:d950caa237bb1954f1b8c9227b5065ba6875ac9771bb8ec790d956a699b78676"},+ {file = "pydantic_core-2.27.1-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0e4216e64d203e39c62df627aa882f02a2438d18a5f21d7f721621f7a5d3611d"},+ {file = "pydantic_core-2.27.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:02a3d637bd387c41d46b002f0e49c52642281edacd2740e5a42f7017feea3f2c"},+ {file = "pydantic_core-2.27.1-pp310-pypy310_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:161c27ccce13b6b0c8689418da3885d3220ed2eae2ea5e9b2f7f3d48f1d52c27"},+ {file = "pydantic_core-2.27.1-pp310-pypy310_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:19910754e4cc9c63bc1c7f6d73aa1cfee82f42007e407c0f413695c2f7ed777f"},+ {file = "pydantic_core-2.27.1-pp310-pypy310_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:e173486019cc283dc9778315fa29a363579372fe67045e971e89b6365cc035ed"},+ {file = "pydantic_core-2.27.1-pp310-pypy310_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:af52d26579b308921b73b956153066481f064875140ccd1dfd4e77db89dbb12f"},+ {file = "pydantic_core-2.27.1-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:981fb88516bd1ae8b0cbbd2034678a39dedc98752f264ac9bc5839d3923fa04c"},+ {file = "pydantic_core-2.27.1-pp39-pypy39_pp73-macosx_10_12_x86_64.whl", hash = "sha256:5fde892e6c697ce3e30c61b239330fc5d569a71fefd4eb6512fc6caec9dd9e2f"},+ {file = "pydantic_core-2.27.1-pp39-pypy39_pp73-macosx_11_0_arm64.whl", hash = "sha256:816f5aa087094099fff7edabb5e01cc370eb21aa1a1d44fe2d2aefdfb5599b31"},+ {file = "pydantic_core-2.27.1-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9c10c309e18e443ddb108f0ef64e8729363adbfd92d6d57beec680f6261556f3"},+ {file = "pydantic_core-2.27.1-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:98476c98b02c8e9b2eec76ac4156fd006628b1b2d0ef27e548ffa978393fd154"},+ {file = "pydantic_core-2.27.1-pp39-pypy39_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c3027001c28434e7ca5a6e1e527487051136aa81803ac812be51802150d880dd"},+ {file = "pydantic_core-2.27.1-pp39-pypy39_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:7699b1df36a48169cdebda7ab5a2bac265204003f153b4bd17276153d997670a"},+ {file = "pydantic_core-2.27.1-pp39-pypy39_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:1c39b07d90be6b48968ddc8c19e7585052088fd7ec8d568bb31ff64c70ae3c97"},+ {file = "pydantic_core-2.27.1-pp39-pypy39_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:46ccfe3032b3915586e469d4972973f893c0a2bb65669194a5bdea9bacc088c2"},+ {file = "pydantic_core-2.27.1-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:62ba45e21cf6571d7f716d903b5b7b6d2617e2d5d67c0923dc47b9d41369f840"},+ {file = "pydantic_core-2.27.1.tar.gz", hash = "sha256:62a763352879b84aa31058fc931884055fd75089cccbd9d58bb6afd01141b235"},][package.dependencies]typing-extensions = ">=4.6.0,<4.7.0 || >4.7.0"+[[package]]+name = "pydantic-settings"+version = "2.9.1"+description = "Settings management using Pydantic"+optional = false+python-versions = ">=3.9"+groups = ["main"]+files = [+ {file = "pydantic_settings-2.9.1-py3-none-any.whl", hash = "sha256:59b4f431b1defb26fe620c71a7d3968a710d719f5f4cdbbdb7926edeb770f6ef"},+ {file = "pydantic_settings-2.9.1.tar.gz", hash = "sha256:c509bf79d27563add44e8446233359004ed85066cd096d8b510f715e6ef5d268"},+]++[package.dependencies]+pydantic = ">=2.7.0"+python-dotenv = ">=0.21.0"+typing-inspection = ">=0.4.0"++[package.extras]+aws-secrets-manager = ["boto3 (>=1.35.0)", "boto3-stubs[secretsmanager]"]+azure-key-vault = ["azure-identity (>=1.16.0)", "azure-keyvault-secrets (>=4.8.0)"]+gcp-secret-manager = ["google-cloud-secret-manager (>=2.23.1)"]+toml = ["tomli (>=2.0.1)"]+yaml = ["pyyaml (>=6.0.1)"]+[[package]]name = "pyfiglet"version = "1.0.2"@@ -1393,6 +1459,21 @@ files = [[package.dependencies]six = ">=1.5"+[[package]]+name = "python-dotenv"+version = "1.1.0"+description = "Read key-value pairs from a .env file and set them as environment variables"+optional = false+python-versions = ">=3.9"+groups = ["main"]+files = [+ {file = "python_dotenv-1.1.0-py3-none-any.whl", hash = "sha256:d7c01d9e2293916c18baf562d95698754b0dbbb5e74d457c45d4f6561fb9d55d"},+ {file = "python_dotenv-1.1.0.tar.gz", hash = "sha256:41f90bc6f5f177fb41f53e87666db362025010eb28f60a01c9143bfa33a2b2d5"},+]++[package.extras]+cli = ["click (>=5.0)"]+[[package]]name = "pyyaml"version = "6.0.2"@@ -1545,6 +1626,44 @@ files = [{file = "sniffio-1.3.1.tar.gz", hash = "sha256:f4324edc670a0f49750a81b895f35c3adb843cca46f0530f79fc1babb23789dc"},]+[[package]]+name = "sse-starlette"+version = "2.2.1"+description = "SSE plugin for Starlette"+optional = false+python-versions = ">=3.9"+groups = ["main"]+files = [+ {file = "sse_starlette-2.2.1-py3-none-any.whl", hash = "sha256:6410a3d3ba0c89e7675d4c273a301d64649c03a5ef1ca101f10b47f895fd0e99"},+ {file = "sse_starlette-2.2.1.tar.gz", hash = "sha256:54470d5f19274aeed6b2d473430b08b4b379ea851d953b11d7f1c4a2c118b419"},+]++[package.dependencies]+anyio = ">=4.7.0"+starlette = ">=0.41.3"++[package.extras]+examples = ["fastapi"]+uvicorn = ["uvicorn (>=0.34.0)"]++[[package]]+name = "starlette"+version = "0.46.2"+description = "The little ASGI library that shines."+optional = false+python-versions = ">=3.9"+groups = ["main"]+files = [+ {file = "starlette-0.46.2-py3-none-any.whl", hash = "sha256:595633ce89f8ffa71a015caed34a5b2dc1c0cdb3f0f1fbd1e69339cf2abeec35"},+ {file = "starlette-0.46.2.tar.gz", hash = "sha256:7f7361f34eed179294600af672f565727419830b54b7b084efe44bb82d2fccd5"},+]++[package.dependencies]+anyio = ">=3.6.2,<5"++[package.extras]+full = ["httpx (>=0.27.0,<0.29.0)", "itsdangerous", "jinja2", "python-multipart (>=0.0.18)", "pyyaml"]+[[package]]name = "tenacity"version = "9.0.0"@@ -1580,7 +1699,7 @@ rich = ">=13.3.3"typing-extensions = ">=4.4.0,<5.0.0"[package.extras]-syntax = ["tree-sitter (>=0.23.0)", "tree-sitter-bash (>=0.23.0)", "tree-sitter-css (>=0.23.0)", "tree-sitter-go (>=0.23.0)", "tree-sitter-html (>=0.23.0)", "tree-sitter-java (>=0.23.0)", "tree-sitter-javascript (>=0.23.0)", "tree-sitter-json (>=0.24.0)", "tree-sitter-markdown (>=0.3.0)", "tree-sitter-python (>=0.23.0)", "tree-sitter-regex (>=0.24.0)", "tree-sitter-rust (>=0.23.0)", "tree-sitter-sql (>=0.3.0)", "tree-sitter-toml (>=0.6.0)", "tree-sitter-xml (>=0.7.0)", "tree-sitter-yaml (>=0.6.0)"]+syntax = ["tree-sitter (>=0.23.0) ; python_version >= \"3.9\"", "tree-sitter-bash (>=0.23.0) ; python_version >= \"3.9\"", "tree-sitter-css (>=0.23.0) ; python_version >= \"3.9\"", "tree-sitter-go (>=0.23.0) ; python_version >= \"3.9\"", "tree-sitter-html (>=0.23.0) ; python_version >= \"3.9\"", "tree-sitter-java (>=0.23.0) ; python_version >= \"3.9\"", "tree-sitter-javascript (>=0.23.0) ; python_version >= \"3.9\"", "tree-sitter-json (>=0.24.0) ; python_version >= \"3.9\"", "tree-sitter-markdown (>=0.3.0) ; python_version >= \"3.9\"", "tree-sitter-python (>=0.23.0) ; python_version >= \"3.9\"", "tree-sitter-regex (>=0.24.0) ; python_version >= \"3.9\"", "tree-sitter-rust (>=0.23.0) ; python_version >= \"3.9\"", "tree-sitter-sql (>=0.3.0) ; python_version >= \"3.9\"", "tree-sitter-toml (>=0.6.0) ; python_version >= \"3.9\"", "tree-sitter-xml (>=0.7.0) ; python_version >= \"3.9\"", "tree-sitter-yaml (>=0.6.0) ; python_version >= \"3.9\""][[package]]name = "tqdm"@@ -1650,6 +1769,21 @@ files = [mypy-extensions = ">=0.3.0"typing-extensions = ">=3.7.4"+[[package]]+name = "typing-inspection"+version = "0.4.0"+description = "Runtime typing introspection tools"+optional = false+python-versions = ">=3.9"+groups = ["main"]+files = [+ {file = "typing_inspection-0.4.0-py3-none-any.whl", hash = "sha256:50e72559fcd2a6367a19f7a7e610e6afcb9fac940c650290eed893d61386832f"},+ {file = "typing_inspection-0.4.0.tar.gz", hash = "sha256:9765c87de36671694a67904bf2c96e395be9c6439bb6c87b5142569dcdd65122"},+]++[package.dependencies]+typing-extensions = ">=4.12.0"+[[package]]name = "uc-micro-py"version = "1.0.3"@@ -1678,11 +1812,30 @@ files = [][package.extras]-brotli = ["brotli (>=1.0.9)", "brotlicffi (>=0.8.0)"]+brotli = ["brotli (>=1.0.9) ; platform_python_implementation == \"CPython\"", "brotlicffi (>=0.8.0) ; platform_python_implementation != \"CPython\""]h2 = ["h2 (>=4,<5)"]socks = ["pysocks (>=1.5.6,!=1.5.7,<2.0)"]zstd = ["zstandard (>=0.18.0)"]+[[package]]+name = "uvicorn"+version = "0.34.2"+description = "The lightning-fast ASGI server."+optional = false+python-versions = ">=3.9"+groups = ["main"]+files = [+ {file = "uvicorn-0.34.2-py3-none-any.whl", hash = "sha256:deb49af569084536d269fe0a6d67e3754f104cf03aba7c11c40f01aadf33c403"},+ {file = "uvicorn-0.34.2.tar.gz", hash = "sha256:0e929828f6186353a80b58ea719861d2629d766293b6d19baf086ba31d4f3328"},+]++[package.dependencies]+click = ">=7.0"+h11 = ">=0.8"++[package.extras]+standard = ["colorama (>=0.4) ; sys_platform == \"win32\"", "httptools (>=0.6.3)", "python-dotenv (>=0.13)", "pyyaml (>=5.1)", "uvloop (>=0.14.0,!=0.15.0,!=0.15.1) ; sys_platform != \"win32\" and sys_platform != \"cygwin\" and platform_python_implementation != \"PyPy\"", "watchfiles (>=0.13)", "websockets (>=10.4)"]+[[package]]name = "yarl"version = "1.18.3"@@ -1782,5 +1935,5 @@ propcache = ">=0.2.0"[metadata]lock-version = "2.1"-python-versions = "^3.11"-content-hash = "5df41a7a20fc2336dd36fc7e5a5d291832a3bfa05335f61c38c0470864795819"+python-versions = ">=3.12,<4.0"+content-hash = "a9a058f38f71738386253ee3848d6c891da04707b698501ba9601040310f4d94"diff --git a/atomic-examples/deep-research/README.md b/atomic-examples/deep-research/README.mdindex 64c0680..2a5098d 100644--- a/atomic-examples/deep-research/README.md+++ b/atomic-examples/deep-research/README.md@@ -27,11 +27,11 @@ This directory contains the Deep Research Agent example for the Atomic Agents prSEARXNG_API_KEY=your_searxng_secret_key```- **Important**: To find your SearxNG secret key, check the `secret_key` value in your SearxNG `settings.yml` file, typically located at `/etc/searxng/settings.yml` or in the SearxNG installation directory.+ **Important**: To find your SearXNG secret key, check the `secret_key` value in your SearXNG `settings.yml` file, typically located at `/etc/searxng/settings.yml` or in the SearXNG installation directory.-5. **Set up SearxNG:**- - Install SearxNG from the [official repository](https://github.com/searxng/searxng)- - Default configuration expects SearxNG at `http://localhost:8080`+5. **Set up SearXNG:**+ - Install SearXNG from the [official repository](https://github.com/searxng/searxng)+ - Default configuration expects SearXNG at `http://localhost:8080`6. **Run the Deep Research Agent:**```bash@@ -48,7 +48,7 @@ This directory contains the Deep Research Agent example for the Atomic Agents pr### 2. Tools (`tools/`)-- **SearxNG Search** (`searxng_search.py`): Performs web searches across multiple engines+- **SearXNG Search** (`searxng_search.py`): Performs web searches across multiple engines- **Webpage Scraper** (`webpage_scraper.py`): Extracts and processes web content### 3. Main (`main.py`)diff --git a/atomic-examples/deep-research/deep_research/agents/query_agent.py b/atomic-examples/deep-research/deep_research/agents/query_agent.pyindex 3362f94..e7d741f 100644--- a/atomic-examples/deep-research/deep_research/agents/query_agent.py+++ b/atomic-examples/deep-research/deep_research/agents/query_agent.py@@ -5,7 +5,7 @@ from pydantic import Fieldfrom atomic_agents.agents.base_agent import BaseIOSchema, BaseAgent, BaseAgentConfigfrom atomic_agents.lib.components.system_prompt_generator import SystemPromptGenerator-from deep_research.tools.searxng_search import SearxNGSearchTool, SearxNGSearchToolInputSchema+from deep_research.tools.searxng_search import SearXNGSearchTool, SearXNGSearchToolInputSchemaclass QueryAgentInputSchema(BaseIOSchema):@@ -15,7 +15,7 @@ class QueryAgentInputSchema(BaseIOSchema):num_queries: int = Field(..., description="The number of search queries to generate.")-query_agent = BaseAgent[QueryAgentInputSchema, SearxNGSearchToolInputSchema](+query_agent = BaseAgent[QueryAgentInputSchema, SearXNGSearchToolInputSchema](BaseAgentConfig(client=instructor.from_openai(openai.OpenAI(api_key=ChatConfig.api_key)),model=ChatConfig.model,diff --git a/atomic-examples/deep-research/deep_research/config.py b/atomic-examples/deep-research/deep_research/config.pyindex bc09ded..12adb04 100644--- a/atomic-examples/deep-research/deep_research/config.py+++ b/atomic-examples/deep-research/deep_research/config.py@@ -12,13 +12,13 @@ def get_api_key() -> str:def get_searxng_base_url() -> str:- """Retrieve SearxNG base URL from environment or use default"""+ """Retrieve SearXNG base URL from environment or use default"""base_url = os.getenv("SEARXNG_BASE_URL", "http://localhost:8080")return base_urldef get_searxng_api_key() -> str:- """Retrieve SearxNG API key from environment"""+ """Retrieve SearXNG API key from environment"""api_key = os.getenv("SEARXNG_API_KEY")return api_keydiff --git a/atomic-examples/deep-research/deep_research/main.py b/atomic-examples/deep-research/deep_research/main.pyindex ae20ced..f4877e1 100644--- a/atomic-examples/deep-research/deep_research/main.py+++ b/atomic-examples/deep-research/deep_research/main.py@@ -5,7 +5,7 @@ from deep_research.agents.qa_agent import (QuestionAnsweringAgentOutputSchema,)from deep_research.agents.choice_agent import choice_agent, ChoiceAgentInputSchema-from deep_research.tools.searxng_search import SearxNGSearchTool, SearxNGSearchToolConfig, SearxNGSearchToolInputSchema+from deep_research.tools.searxng_search import SearXNGSearchTool, SearXNGSearchToolConfig, SearXNGSearchToolInputSchemafrom deep_research.tools.webpage_scraper import WebpageScraperTool, WebpageScraperToolInputSchemafrom deep_research.context_providers import ContentItem, CurrentDateContextProvider, ScrapedContentContextProvider@@ -51,9 +51,9 @@ def perform_search_and_update_context(# Perform the searchtask = progress.add_task("[cyan]Searching the web...", total=None)- console.print("\n[bold yellow]π Searching across the web using SearxNG...[/bold yellow]")- searxng_search_tool = SearxNGSearchTool(SearxNGSearchToolConfig(base_url="http://localhost:8080/"))- search_results = searxng_search_tool.run(SearxNGSearchToolInputSchema(queries=query_agent_output.queries))+ console.print("\n[bold yellow]π Searching across the web using SearXNG...[/bold yellow]")+ searxng_search_tool = SearXNGSearchTool(SearXNGSearchToolConfig(base_url="http://localhost:8080/"))+ search_results = searxng_search_tool.run(SearXNGSearchToolInputSchema(queries=query_agent_output.queries))progress.remove_task(task)# Scrape content from search resultsdiff --git a/atomic-examples/deep-research/deep_research/tools/searxng_search.py b/atomic-examples/deep-research/deep_research/tools/searxng_search.pyindex a29d557..6825485 100644--- a/atomic-examples/deep-research/deep_research/tools/searxng_search.py+++ b/atomic-examples/deep-research/deep_research/tools/searxng_search.py@@ -12,9 +12,9 @@ from atomic_agents.lib.base.base_tool import BaseTool, BaseToolConfig################# INPUT SCHEMA #################-class SearxNGSearchToolInputSchema(BaseIOSchema):+class SearXNGSearchToolInputSchema(BaseIOSchema):"""- Schema for input to a tool for searching for information, news, references, and other content using SearxNG.+ Schema for input to a tool for searching for information, news, references, and other content using SearXNG.Returns a list of search results with a short description or content snippet and URLs for further exploration"""@@ -27,7 +27,7 @@ class SearxNGSearchToolInputSchema(BaseIOSchema):##################### OUTPUT SCHEMA(S) #####################-class SearxNGSearchResultItemSchema(BaseIOSchema):+class SearXNGSearchResultItemSchema(BaseIOSchema):"""This schema represents a single search result item"""url: str = Field(..., description="The URL of the search result")@@ -36,38 +36,38 @@ class SearxNGSearchResultItemSchema(BaseIOSchema):query: str = Field(..., description="The query used to obtain this search result")-class SearxNGSearchToolOutputSchema(BaseIOSchema):- """This schema represents the output of the SearxNG search tool."""+class SearXNGSearchToolOutputSchema(BaseIOSchema):+ """This schema represents the output of the SearXNG search tool."""- results: List[SearxNGSearchResultItemSchema] = Field(..., description="List of search result items")+ results: List[SearXNGSearchResultItemSchema] = Field(..., description="List of search result items")category: Optional[str] = Field(None, description="The category of the search results")############### TOOL LOGIC ###############-class SearxNGSearchToolConfig(BaseToolConfig):+class SearXNGSearchToolConfig(BaseToolConfig):base_url: str = ""max_results: int = 10-class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolOutputSchema]):+class SearXNGSearchTool(BaseTool[SearXNGSearchToolInputSchema, SearXNGSearchToolOutputSchema]):"""- Tool for performing searches on SearxNG based on the provided queries and category.+ Tool for performing searches on SearXNG based on the provided queries and category.Attributes:- input_schema (SearxNGSearchToolInputSchema): The schema for the input data.- output_schema (SearxNGSearchToolOutputSchema): The schema for the output data.+ input_schema (SearXNGSearchToolInputSchema): The schema for the input data.+ output_schema (SearXNGSearchToolOutputSchema): The schema for the output data.max_results (int): The maximum number of search results to return.- base_url (str): The base URL for the SearxNG instance to use.+ base_url (str): The base URL for the SearXNG instance to use."""- def __init__(self, config: SearxNGSearchToolConfig = SearxNGSearchToolConfig()):+ def __init__(self, config: SearXNGSearchToolConfig = SearXNGSearchToolConfig()):"""- Initializes the SearxNGTool.+ Initializes the SearXNGTool.Args:- config (SearxNGSearchToolConfig):+ config (SearXNGSearchToolConfig):Configuration for the tool, including base URL, max results, and optional title and description overrides."""super().__init__(config)@@ -87,7 +87,7 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolList[dict]: A list of search result dictionaries.Raises:- Exception: If the request to SearxNG fails.+ Exception: If the request to SearXNG fails."""query_params = {"q": query,@@ -113,21 +113,21 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolreturn resultsasync def run_async(- self, params: SearxNGSearchToolInputSchema, max_results: Optional[int] = None- ) -> SearxNGSearchToolOutputSchema:+ self, params: SearXNGSearchToolInputSchema, max_results: Optional[int] = None+ ) -> SearXNGSearchToolOutputSchema:"""- Runs the SearxNGTool asynchronously with the given parameters.+ Runs the SearXNGTool asynchronously with the given parameters.Args:- params (SearxNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.+ params (SearXNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.max_results (Optional[int]): The maximum number of search results to return.Returns:- SearxNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.+ SearXNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.Raises:ValueError: If the base URL is not provided.- Exception: If the request to SearxNG fails.+ Exception: If the request to SearXNG fails."""async with aiohttp.ClientSession() as session:tasks = [self._fetch_search_results(session, query, params.category) for query in params.queries]@@ -160,9 +160,9 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolfiltered_results = filtered_results[: max_results or self.max_results]- return SearxNGSearchToolOutputSchema(+ return SearXNGSearchToolOutputSchema(results=[- SearxNGSearchResultItemSchema(+ SearXNGSearchResultItemSchema(url=result["url"], title=result["title"], content=result.get("content"), query=result["query"])for result in filtered_results@@ -170,22 +170,22 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolcategory=params.category,)- def run(self, params: SearxNGSearchToolInputSchema, max_results: Optional[int] = None) -> SearxNGSearchToolOutputSchema:+ def run(self, params: SearXNGSearchToolInputSchema, max_results: Optional[int] = None) -> SearXNGSearchToolOutputSchema:"""- Runs the SearxNGTool synchronously with the given parameters.+ Runs the SearXNGTool synchronously with the given parameters.This method creates an event loop in a separate thread to run the asynchronous operations.Args:- params (SearxNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.+ params (SearXNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.max_results (Optional[int]): The maximum number of search results to return.Returns:- SearxNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.+ SearXNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.Raises:ValueError: If the base URL is not provided.- Exception: If the request to SearxNG fails.+ Exception: If the request to SearXNG fails."""with ThreadPoolExecutor() as executor:return executor.submit(asyncio.run, self.run_async(params, max_results)).result()@@ -201,9 +201,9 @@ if __name__ == "__main__":load_dotenv()rich_console = Console()- search_tool_instance = SearxNGSearchTool(config=SearxNGSearchToolConfig(base_url="http://localhost:8080", max_results=5))+ search_tool_instance = SearXNGSearchTool(config=SearXNGSearchToolConfig(base_url="http://localhost:8080", max_results=5))- search_input = SearxNGSearchToolInputSchema(+ search_input = SearXNGSearchToolInputSchema(queries=["Python programming", "Machine learning", "Artificial intelligence"],category="news",)diff --git a/atomic-examples/deep-research/mermaid.md b/atomic-examples/deep-research/mermaid.mdindex f2085cc..3928580 100644--- a/atomic-examples/deep-research/mermaid.md+++ b/atomic-examples/deep-research/mermaid.md@@ -34,7 +34,7 @@ graph TDendsubgraph Tools["External Tools"]- ST[SearxNG Search]+ ST[SearXNG Search]WS[Webpage Scraper]enddiff --git a/atomic-examples/mcp-agent/example-client/example_client/main_stdio.py b/atomic-examples/mcp-agent/example-client/example_client/main_stdio.pyindex 1c9ea25..7bea079 100644--- a/atomic-examples/mcp-agent/example-client/example_client/main_stdio.py+++ b/atomic-examples/mcp-agent/example-client/example_client/main_stdio.py@@ -132,7 +132,7 @@ def main():# Create and initialize orchestrator agentconsole.print("[dim]β’ Creating orchestrator agent...[/dim]")memory = AgentMemory()- orchestrator_agent = BaseAgent(+ orchestrator_agent = BaseAgent[MCPOrchestratorInputSchema, OrchestratorOutputSchema](BaseAgentConfig(client=client,model=config.openai_model,@@ -157,9 +157,7 @@ def main():"4. Maintain a professional and helpful tone in all responses.","5. Break down complex queries into sequential tool calls before giving the final answer via `FinalResponseSchema`.",],- ),- input_schema=MCPOrchestratorInputSchema,- output_schema=OrchestratorOutputSchema,+ )))console.print("[green]Successfully created orchestrator agent.[/green]")@@ -167,7 +165,7 @@ def main():console.print("[bold green]MCP Agent Interactive Chat (STDIO mode). Type 'exit' or 'quit' to leave.[/bold green]")while True:query = console.input("[bold yellow]You:[/bold yellow] ").strip()- if query.lower() in {"exit", "quit"}:+ if query.lower() in {"/exit", "/quit"}:console.print("[bold red]Exiting chat. Goodbye![/bold red]")breakif not query:diff --git a/atomic-examples/orchestration-agent/README.md b/atomic-examples/orchestration-agent/README.mdindex 1ca536a..f1c16d7 100644--- a/atomic-examples/orchestration-agent/README.md+++ b/atomic-examples/orchestration-agent/README.md@@ -32,7 +32,7 @@ This example demonstrates how to create an Orchestrator Agent that intelligentlyOPENAI_API_KEY=your_openai_api_key```-5. Install SearxNG (See: https://github.com/searxng/searxng)+5. Install SearXNG (See: https://github.com/searxng/searxng)6. Run the example:```bash@@ -50,7 +50,7 @@ This example demonstrates how to create an Orchestrator Agent that intelligently### ToolsThese tools were installed using the Atomic Assembler CLI (See the main README [here](../../README.md) for more info)The agent orchestrates between two tools:-- **SearxNG Search Tool**: For queries requiring factual information+- **SearXNG Search Tool**: For queries requiring factual information- **Calculator Tool**: For mathematical calculations### Context Providersdiff --git a/atomic-examples/orchestration-agent/orchestration_agent/orchestrator.py b/atomic-examples/orchestration-agent/orchestration_agent/orchestrator.pyindex 6f8a204..820c59c 100644--- a/atomic-examples/orchestration-agent/orchestration_agent/orchestrator.py+++ b/atomic-examples/orchestration-agent/orchestration_agent/orchestrator.py@@ -7,10 +7,10 @@ from atomic_agents.lib.components.agent_memory import AgentMemoryfrom atomic_agents.lib.components.system_prompt_generator import SystemPromptGenerator, SystemPromptContextProviderBasefrom orchestration_agent.tools.searxng_search import (- SearxNGSearchTool,- SearxNGSearchToolConfig,- SearxNGSearchToolInputSchema,- SearxNGSearchToolOutputSchema,+ SearXNGSearchTool,+ SearXNGSearchToolConfig,+ SearXNGSearchToolInputSchema,+ SearXNGSearchToolOutputSchema,)from orchestration_agent.tools.calculator import (CalculatorTool,@@ -36,7 +36,7 @@ class OrchestratorOutputSchema(BaseIOSchema):"""Combined output schema for the Orchestrator Agent. Contains the tool to use and its parameters."""tool: str = Field(..., description="The tool to use: 'search' or 'calculator'")- tool_parameters: Union[SearxNGSearchToolInputSchema, CalculatorToolInputSchema] = Field(+ tool_parameters: Union[SearXNGSearchToolInputSchema, CalculatorToolInputSchema] = Field(..., description="The parameters for the selected tool")@@ -53,7 +53,7 @@ class FinalAnswerSchema(BaseIOSchema):class OrchestratorAgentConfig(BaseAgentConfig):"""Configuration for the Orchestrator Agent."""- searxng_config: SearxNGSearchToolConfig+ searxng_config: SearXNGSearchToolConfigcalculator_config: CalculatorToolConfig@@ -98,8 +98,8 @@ orchestrator_agent.register_context_provider("current_date", CurrentDateProviderdef execute_tool(- searxng_tool: SearxNGSearchTool, calculator_tool: CalculatorTool, orchestrator_output: OrchestratorOutputSchema-) -> Union[SearxNGSearchToolOutputSchema, CalculatorToolOutputSchema]:+ searxng_tool: SearXNGSearchTool, calculator_tool: CalculatorTool, orchestrator_output: OrchestratorOutputSchema+) -> Union[SearXNGSearchToolOutputSchema, CalculatorToolOutputSchema]:if orchestrator_output.tool == "search":return searxng_tool.run(orchestrator_output.tool_parameters)elif orchestrator_output.tool == "calculator":@@ -124,7 +124,7 @@ if __name__ == "__main__":client = instructor.from_openai(openai.OpenAI(api_key=os.getenv("OPENAI_API_KEY")))# Initialize the tools- searxng_tool = SearxNGSearchTool(SearxNGSearchToolConfig(base_url="http://localhost:8080", max_results=5))+ searxng_tool = SearXNGSearchTool(SearXNGSearchToolConfig(base_url="http://localhost:8080", max_results=5))calculator_tool = CalculatorTool(CalculatorToolConfig())# Initialize Rich consolediff --git a/atomic-examples/orchestration-agent/orchestration_agent/tools/searxng_search.py b/atomic-examples/orchestration-agent/orchestration_agent/tools/searxng_search.pyindex ab78f49..c7a12ef 100644--- a/atomic-examples/orchestration-agent/orchestration_agent/tools/searxng_search.py+++ b/atomic-examples/orchestration-agent/orchestration_agent/tools/searxng_search.py@@ -12,9 +12,9 @@ from atomic_agents.lib.base.base_tool import BaseTool, BaseToolConfig################# INPUT SCHEMA #################-class SearxNGSearchToolInputSchema(BaseIOSchema):+class SearXNGSearchToolInputSchema(BaseIOSchema):"""- Schema for input to a tool for searching for information, news, references, and other content using SearxNG.+ Schema for input to a tool for searching for information, news, references, and other content using SearXNG.Returns a list of search results with a short description or content snippet and URLs for further exploration"""@@ -27,7 +27,7 @@ class SearxNGSearchToolInputSchema(BaseIOSchema):##################### OUTPUT SCHEMA(S) #####################-class SearxNGSearchResultItemSchema(BaseIOSchema):+class SearXNGSearchResultItemSchema(BaseIOSchema):"""This schema represents a single search result item"""url: str = Field(..., description="The URL of the search result")@@ -36,41 +36,41 @@ class SearxNGSearchResultItemSchema(BaseIOSchema):query: str = Field(..., description="The query used to obtain this search result")-class SearxNGSearchToolOutputSchema(BaseIOSchema):- """This schema represents the output of the SearxNG search tool."""+class SearXNGSearchToolOutputSchema(BaseIOSchema):+ """This schema represents the output of the SearXNG search tool."""- results: List[SearxNGSearchResultItemSchema] = Field(..., description="List of search result items")+ results: List[SearXNGSearchResultItemSchema] = Field(..., description="List of search result items")category: Optional[str] = Field(None, description="The category of the search results")############### TOOL LOGIC ###############-class SearxNGSearchToolConfig(BaseToolConfig):+class SearXNGSearchToolConfig(BaseToolConfig):base_url: str = ""max_results: int = 10-class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolOutputSchema]):+class SearXNGSearchTool(BaseTool[SearXNGSearchToolInputSchema, SearXNGSearchToolOutputSchema]):"""- Tool for performing searches on SearxNG based on the provided queries and category.+ Tool for performing searches on SearXNG based on the provided queries and category.Attributes:- input_schema (SearxNGSearchToolInputSchema): The schema for the input data.- output_schema (SearxNGSearchToolOutputSchema): The schema for the output data.+ input_schema (SearXNGSearchToolInputSchema): The schema for the input data.+ output_schema (SearXNGSearchToolOutputSchema): The schema for the output data.max_results (int): The maximum number of search results to return.- base_url (str): The base URL for the SearxNG instance to use.+ base_url (str): The base URL for the SearXNG instance to use."""- input_schema = SearxNGSearchToolInputSchema- output_schema = SearxNGSearchToolOutputSchema+ input_schema = SearXNGSearchToolInputSchema+ output_schema = SearXNGSearchToolOutputSchema- def __init__(self, config: SearxNGSearchToolConfig = SearxNGSearchToolConfig()):+ def __init__(self, config: SearXNGSearchToolConfig = SearXNGSearchToolConfig()):"""- Initializes the SearxNGTool.+ Initializes the SearXNGTool.Args:- config (SearxNGSearchToolConfig):+ config (SearXNGSearchToolConfig):Configuration for the tool, including base URL, max results, and optional title and description overrides."""super().__init__(config)@@ -90,7 +90,7 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolList[dict]: A list of search result dictionaries.Raises:- Exception: If the request to SearxNG fails.+ Exception: If the request to SearXNG fails."""query_params = {"q": query,@@ -116,21 +116,21 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolreturn resultsasync def run_async(- self, params: SearxNGSearchToolInputSchema, max_results: Optional[int] = None- ) -> SearxNGSearchToolOutputSchema:+ self, params: SearXNGSearchToolInputSchema, max_results: Optional[int] = None+ ) -> SearXNGSearchToolOutputSchema:"""- Runs the SearxNGTool asynchronously with the given parameters.+ Runs the SearXNGTool asynchronously with the given parameters.Args:- params (SearxNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.+ params (SearXNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.max_results (Optional[int]): The maximum number of search results to return.Returns:- SearxNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.+ SearXNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.Raises:ValueError: If the base URL is not provided.- Exception: If the request to SearxNG fails.+ Exception: If the request to SearXNG fails."""async with aiohttp.ClientSession() as session:tasks = [self._fetch_search_results(session, query, params.category) for query in params.queries]@@ -163,9 +163,9 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolfiltered_results = filtered_results[: max_results or self.max_results]- return SearxNGSearchToolOutputSchema(+ return SearXNGSearchToolOutputSchema(results=[- SearxNGSearchResultItemSchema(+ SearXNGSearchResultItemSchema(url=result["url"], title=result["title"], content=result.get("content"), query=result["query"])for result in filtered_results@@ -173,22 +173,22 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolcategory=params.category,)- def run(self, params: SearxNGSearchToolInputSchema, max_results: Optional[int] = None) -> SearxNGSearchToolOutputSchema:+ def run(self, params: SearXNGSearchToolInputSchema, max_results: Optional[int] = None) -> SearXNGSearchToolOutputSchema:"""- Runs the SearxNGTool synchronously with the given parameters.+ Runs the SearXNGTool synchronously with the given parameters.This method creates an event loop in a separate thread to run the asynchronous operations.Args:- params (SearxNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.+ params (SearXNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.max_results (Optional[int]): The maximum number of search results to return.Returns:- SearxNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.+ SearXNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.Raises:ValueError: If the base URL is not provided.- Exception: If the request to SearxNG fails.+ Exception: If the request to SearXNG fails."""with ThreadPoolExecutor() as executor:return executor.submit(asyncio.run, self.run_async(params, max_results)).result()@@ -204,9 +204,9 @@ if __name__ == "__main__":load_dotenv()rich_console = Console()- search_tool_instance = SearxNGSearchTool(config=SearxNGSearchToolConfig(base_url="http://localhost:8080", max_results=5))+ search_tool_instance = SearXNGSearchTool(config=SearXNGSearchToolConfig(base_url="http://localhost:8080", max_results=5))- search_input = SearxNGSearchTool.input_schema(+ search_input = SearXNGSearchTool.input_schema(queries=["Python programming", "Machine learning", "Artificial intelligence"],category="news",)diff --git a/atomic-examples/rag-chatbot/chroma_db/f693e460-208a-4c16-bee8-249df4f2b13e/link_lists.bin b/atomic-examples/quickstart/quickstart/6_asynchronous_processing_streaming.pysimilarity index 100%rename from atomic-examples/rag-chatbot/chroma_db/f693e460-208a-4c16-bee8-249df4f2b13e/link_lists.binrename to atomic-examples/quickstart/quickstart/6_asynchronous_processing_streaming.pydiff --git a/atomic-examples/rag-chatbot/chroma_db/f693e460-208a-4c16-bee8-249df4f2b13e/data_level0.bin b/atomic-examples/rag-chatbot/chroma_db/3de62bf3-a2c1-4644-abbf-523aa6b23eff/data_level0.binsimilarity index 100%rename from atomic-examples/rag-chatbot/chroma_db/f693e460-208a-4c16-bee8-249df4f2b13e/data_level0.binrename to atomic-examples/rag-chatbot/chroma_db/3de62bf3-a2c1-4644-abbf-523aa6b23eff/data_level0.bindiff --git a/atomic-examples/rag-chatbot/chroma_db/f693e460-208a-4c16-bee8-249df4f2b13e/header.bin b/atomic-examples/rag-chatbot/chroma_db/3de62bf3-a2c1-4644-abbf-523aa6b23eff/header.binsimilarity index 100%rename from atomic-examples/rag-chatbot/chroma_db/f693e460-208a-4c16-bee8-249df4f2b13e/header.binrename to atomic-examples/rag-chatbot/chroma_db/3de62bf3-a2c1-4644-abbf-523aa6b23eff/header.bindiff --git a/atomic-examples/rag-chatbot/chroma_db/3de62bf3-a2c1-4644-abbf-523aa6b23eff/length.bin b/atomic-examples/rag-chatbot/chroma_db/3de62bf3-a2c1-4644-abbf-523aa6b23eff/length.binnew file mode 100644index 0000000..1dc89f8Binary files /dev/null and b/atomic-examples/rag-chatbot/chroma_db/3de62bf3-a2c1-4644-abbf-523aa6b23eff/length.bin differdiff --git a/atomic-examples/rag-chatbot/chroma_db/3de62bf3-a2c1-4644-abbf-523aa6b23eff/link_lists.bin b/atomic-examples/rag-chatbot/chroma_db/3de62bf3-a2c1-4644-abbf-523aa6b23eff/link_lists.binnew file mode 100644index 0000000..e69de29diff --git a/atomic-examples/rag-chatbot/chroma_db/chroma.sqlite3 b/atomic-examples/rag-chatbot/chroma_db/chroma.sqlite3index 8d8ce32..b3540b5 100644Binary files a/atomic-examples/rag-chatbot/chroma_db/chroma.sqlite3 and b/atomic-examples/rag-chatbot/chroma_db/chroma.sqlite3 differdiff --git a/atomic-examples/rag-chatbot/chroma_db/f693e460-208a-4c16-bee8-249df4f2b13e/length.bin b/atomic-examples/rag-chatbot/chroma_db/f693e460-208a-4c16-bee8-249df4f2b13e/length.bindeleted file mode 100644index a734448..0000000Binary files a/atomic-examples/rag-chatbot/chroma_db/f693e460-208a-4c16-bee8-249df4f2b13e/length.bin and /dev/null differdiff --git a/atomic-examples/rag-chatbot/rag_chatbot/main.py b/atomic-examples/rag-chatbot/rag_chatbot/main.pyindex ea810c0..a13284e 100644--- a/atomic-examples/rag-chatbot/rag_chatbot/main.py+++ b/atomic-examples/rag-chatbot/rag_chatbot/main.py@@ -201,10 +201,17 @@ def chat_loop(chroma_db: ChromaDBService, rag_context: RAGContextProvider) -> Notry:user_message = console.input("\n[bold blue]Your question:[/bold blue] ").strip()- if user_message.lower() == "exit":+ if user_message.lower() in ["/exit", "/quit"]:console.print("\n[bold]π Goodbye! Thanks for using the RAG Chatbot.[/bold]")break+ try:+ i_question = int(user_message) - 1+ if 0 <= i_question < len(STARTER_QUESTIONS):+ user_message = STARTER_QUESTIONS[i_question]+ except ValueError:+ pass+console.print("\n" + "β" * 80)console.print("\n[bold magenta]π Processing your question...[/bold magenta]")diff --git a/atomic-examples/web-search-agent/README.md b/atomic-examples/web-search-agent/README.mdindex 3eedcc4..3ee6031 100644--- a/atomic-examples/web-search-agent/README.md+++ b/atomic-examples/web-search-agent/README.md@@ -14,7 +14,7 @@ This project demonstrates an intelligent web search agent built using the AtomicThe Web Search Agent consists of several key components:1. Query Agent (`query_agent.py`): Generates diverse and relevant search queries based on user input.-2. SearXNG Search Tool (`searxng_search.py`): Performs web searches using the SearxNG meta-search engine.+2. SearXNG Search Tool (`searxng_search.py`): Performs web searches using the SearXNG meta-search engine.3. Question Answering Agent (`question_answering_agent.py`): Analyzes search results and provides detailed answers to user questions.4. Main Script (`main.py`): Orchestrates the entire process, from query generation to final answer presentation.@@ -22,6 +22,17 @@ The Web Search Agent consists of several key components:To run the Web Search Agent:+1. Setting up SearXNG server if you haven't:++Make sure to add these lines to `settings.tml`:++ ```yaml+ search:+ formats:+ - html+ - json+ ```+1. Clone the Atomic Agents repository:```bash@@ -48,7 +59,7 @@ To run the Web Search Agent:SEARXNG_BASE_URL=your_searxng_instance_url```- Replace `your_openai_api_key` with your actual OpenAI API key and `your_searxng_instance_url` with the URL of your SearxNG instance.+ Replace `your_openai_api_key` with your actual OpenAI API key and `your_searxng_instance_url` with the URL of your SearXNG instance.1. Run the Web Search Agent:@@ -60,7 +71,7 @@ To run the Web Search Agent:1. The user provides an initial question or topic for research.2. The Query Agent generates multiple relevant search queries based on the user's input.-3. The SearxNG Search Tool performs web searches using the generated queries.+3. The SearXNG Search Tool performs web searches using the generated queries.4. The Question Answering Agent analyzes the search results and formulates a detailed answer.5. The main script presents the answer, along with references and follow-up questions.diff --git a/atomic-examples/web-search-agent/web_search_agent/agents/query_agent.py b/atomic-examples/web-search-agent/web_search_agent/agents/query_agent.pyindex 242c10d..2c6a732 100644--- a/atomic-examples/web-search-agent/web_search_agent/agents/query_agent.py+++ b/atomic-examples/web-search-agent/web_search_agent/agents/query_agent.py@@ -5,7 +5,7 @@ from typing import Listfrom atomic_agents.agents.base_agent import BaseIOSchema, BaseAgent, BaseAgentConfigfrom atomic_agents.lib.components.system_prompt_generator import SystemPromptGenerator-from web_search_agent.tools.searxng_search import SearxNGSearchTool+from web_search_agent.tools.searxng_search import SearXNGSearchToolclass QueryAgentInputSchema(BaseIOSchema):diff --git a/atomic-examples/web-search-agent/web_search_agent/main.py b/atomic-examples/web-search-agent/web_search_agent/main.pyindex dfc73ea..f0ee760 100644--- a/atomic-examples/web-search-agent/web_search_agent/main.py+++ b/atomic-examples/web-search-agent/web_search_agent/main.py@@ -9,10 +9,10 @@ from atomic_agents.lib.components.agent_memory import AgentMemoryfrom atomic_agents.lib.components.system_prompt_generator import SystemPromptContextProviderBasefrom web_search_agent.tools.searxng_search import (- SearxNGSearchTool,- SearxNGSearchToolConfig,- SearxNGSearchToolInputSchema,- SearxNGSearchToolOutputSchema+ SearXNGSearchTool,+ SearXNGSearchToolConfig,+ SearXNGSearchToolInputSchema,+ SearXNGSearchToolOutputSchema)from web_search_agent.agents.query_agent import QueryAgentInputSchema, query_agent@@ -29,12 +29,12 @@ console = Console()# Memory setupmemory = AgentMemory()-# Initialize the SearxNGSearchTool-search_tool = SearxNGSearchTool(config=SearxNGSearchToolConfig(base_url=os.getenv("SEARXNG_BASE_URL"), max_results=5))+# Initialize the SearXNGSearchTool+search_tool = SearXNGSearchTool(config=SearXNGSearchToolConfig(base_url=os.getenv("SEARXNG_BASE_URL"), max_results=5))class SearchResultsProvider(SystemPromptContextProviderBase):- def __init__(self, title: str, search_results: SearxNGSearchToolOutputSchema|Exception):+ def __init__(self, title: str, search_results: SearXNGSearchToolOutputSchema|Exception):super().__init__(title=title)self.search_results = search_results@@ -79,7 +79,7 @@ while True:console.print(f"- {query}")# Perform searches using the generated queries- search_input = SearxNGSearchToolInputSchema(queries=generated_queries.queries, category="general")+ search_input = SearXNGSearchToolInputSchema(queries=generated_queries.queries, category="general")try:search_results = search_tool.run(search_input)diff --git a/atomic-examples/web-search-agent/web_search_agent/tools/searxng_search.py b/atomic-examples/web-search-agent/web_search_agent/tools/searxng_search.pyindex e874377..ccd0267 100644--- a/atomic-examples/web-search-agent/web_search_agent/tools/searxng_search.py+++ b/atomic-examples/web-search-agent/web_search_agent/tools/searxng_search.py@@ -13,9 +13,9 @@ from atomic_agents.lib.base.base_tool import BaseTool, BaseToolConfig################# INPUT SCHEMA #################-class SearxNGSearchToolInputSchema(BaseIOSchema):+class SearXNGSearchToolInputSchema(BaseIOSchema):"""- Schema for input to a tool for searching for information, news, references, and other content using SearxNG.+ Schema for input to a tool for searching for information, news, references, and other content using SearXNG.Returns a list of search results with a short description or content snippet and URLs for further exploration"""@@ -28,7 +28,7 @@ class SearxNGSearchToolInputSchema(BaseIOSchema):##################### OUTPUT SCHEMA(S) #####################-class SearxNGSearchResultItemSchema(BaseIOSchema):+class SearXNGSearchResultItemSchema(BaseIOSchema):"""This schema represents a single search result item"""url: str = Field(..., description="The URL of the search result")@@ -37,38 +37,38 @@ class SearxNGSearchResultItemSchema(BaseIOSchema):query: str = Field(..., description="The query used to obtain this search result")-class SearxNGSearchToolOutputSchema(BaseIOSchema):- """This schema represents the output of the SearxNG search tool."""+class SearXNGSearchToolOutputSchema(BaseIOSchema):+ """This schema represents the output of the SearXNG search tool."""- results: List[SearxNGSearchResultItemSchema] = Field(..., description="List of search result items")+ results: List[SearXNGSearchResultItemSchema] = Field(..., description="List of search result items")category: Optional[str] = Field(None, description="The category of the search results")############### TOOL LOGIC ###############-class SearxNGSearchToolConfig(BaseToolConfig):+class SearXNGSearchToolConfig(BaseToolConfig):base_url: str = ""max_results: int = 10-class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolOutputSchema]):+class SearXNGSearchTool(BaseTool[SearXNGSearchToolInputSchema, SearXNGSearchToolOutputSchema]):"""- Tool for performing searches on SearxNG based on the provided queries and category.+ Tool for performing searches on SearXNG based on the provided queries and category.Attributes:- input_schema (SearxNGSearchToolInputSchema): The schema for the input data.- output_schema (SearxNGSearchToolOutputSchema): The schema for the output data.+ input_schema (SearXNGSearchToolInputSchema): The schema for the input data.+ output_schema (SearXNGSearchToolOutputSchema): The schema for the output data.max_results (int): The maximum number of search results to return.- base_url (str): The base URL for the SearxNG instance to use.+ base_url (str): The base URL for the SearXNG instance to use."""- def __init__(self, config: SearxNGSearchToolConfig = SearxNGSearchToolConfig()):+ def __init__(self, config: SearXNGSearchToolConfig = SearXNGSearchToolConfig()):"""- Initializes the SearxNGTool.+ Initializes the SearXNGTool.Args:- config (SearxNGSearchToolConfig):+ config (SearXNGSearchToolConfig):Configuration for the tool, including base URL, max results, and optional title and description overrides."""super().__init__(config)@@ -88,7 +88,7 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolList[dict]: A list of search result dictionaries.Raises:- Exception: If the request to SearxNG fails.+ Exception: If the request to SearXNG fails."""query_params = {"q": query,@@ -114,21 +114,21 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolreturn resultsasync def run_async(- self, params: SearxNGSearchToolInputSchema, max_results: Optional[int] = None- ) -> SearxNGSearchToolOutputSchema:+ self, params: SearXNGSearchToolInputSchema, max_results: Optional[int] = None+ ) -> SearXNGSearchToolOutputSchema:"""- Runs the SearxNGTool asynchronously with the given parameters.+ Runs the SearXNGTool asynchronously with the given parameters.Args:- params (SearxNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.+ params (SearXNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.max_results (Optional[int]): The maximum number of search results to return.Returns:- SearxNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.+ SearXNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.Raises:ValueError: If the base URL is not provided.- Exception: If the request to SearxNG fails.+ Exception: If the request to SearXNG fails."""async with aiohttp.ClientSession() as session:tasks = [self._fetch_search_results(session, query, params.category) for query in params.queries]@@ -161,9 +161,9 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolfiltered_results = filtered_results[: max_results or self.max_results]- return SearxNGSearchToolOutputSchema(+ return SearXNGSearchToolOutputSchema(results=[- SearxNGSearchResultItemSchema(+ SearXNGSearchResultItemSchema(url=result["url"], title=result["title"], content=result.get("content"), query=result["query"])for result in filtered_results@@ -171,22 +171,22 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolcategory=params.category,)- def run(self, params: SearxNGSearchToolInputSchema, max_results: Optional[int] = None) -> SearxNGSearchToolOutputSchema:+ def run(self, params: SearXNGSearchToolInputSchema, max_results: Optional[int] = None) -> SearXNGSearchToolOutputSchema:"""- Runs the SearxNGTool synchronously with the given parameters.+ Runs the SearXNGTool synchronously with the given parameters.This method creates an event loop in a separate thread to run the asynchronous operations.Args:- params (SearxNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.+ params (SearXNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.max_results (Optional[int]): The maximum number of search results to return.Returns:- SearxNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.+ SearXNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.Raises:ValueError: If the base URL is not provided.- Exception: If the request to SearxNG fails.+ Exception: If the request to SearXNG fails."""with ThreadPoolExecutor() as executor:return executor.submit(asyncio.run, self.run_async(params, max_results)).result()@@ -202,11 +202,11 @@ if __name__ == "__main__":load_dotenv()rich_console = Console()- search_tool_instance = SearxNGSearchTool(- config=SearxNGSearchToolConfig(base_url=os.getenv("SEARXNG_BASE_URL"), max_results=5)+ search_tool_instance = SearXNGSearchTool(+ config=SearXNGSearchToolConfig(base_url=os.getenv("SEARXNG_BASE_URL"), max_results=5))- search_input = SearxNGSearchTool.input_schema(+ search_input = SearXNGSearchTool.input_schema(queries=["Python programming", "Machine learning", "Artificial intelligence"],category="news",)diff --git a/atomic-forge/README.md b/atomic-forge/README.mdindex 3eb010d..10e25fc 100644--- a/atomic-forge/README.md+++ b/atomic-forge/README.md@@ -14,7 +14,7 @@ Please use the [Atomic Assembler CLI](../README.md) as mentioned in the main [REThe Atomic Forge project includes the following tools:- [Calculator](/atomic-forge/tools/calculator/README.md)-- [SearxNG Search](/atomic-forge/tools/searxng_search/README.md)+- [SearXNG Search](/atomic-forge/tools/searxng_search/README.md)- [Tavily Search](/atomic-forge/tools/tavily_search/README.md)- [YouTube Transcript Scraper](/atomic-forge/tools/youtube_transcript_scraper/README.md)- [Webpage Scraper](/atomic-forge/tools/webpage_scraper/README.md)diff --git a/atomic-forge/tools/searxng_search/README.md b/atomic-forge/tools/searxng_search/README.mdindex 4f7ad0e..34537b9 100644--- a/atomic-forge/tools/searxng_search/README.md+++ b/atomic-forge/tools/searxng_search/README.md@@ -1,7 +1,7 @@-# SearxNG Search Tool+# SearXNG Search Tool## Overview-The SearxNG Search Tool is a powerful utility within the Atomic Agents ecosystem that allows you to perform searches using SearxNG, a privacy-respecting metasearch engine. This tool enables you to fetch search results from multiple sources while maintaining user privacy.+The SearXNG Search Tool is a powerful utility within the Atomic Agents ecosystem that allows you to perform searches using SearXNG, a privacy-respecting metasearch engine. This tool enables you to fetch search results from multiple sources while maintaining user privacy.## Prerequisites and Dependencies- Python 3.9 or later@@ -19,13 +19,13 @@ You can install the tool using any of the following options:### Parameters-- `base_url` (str): The base URL of the SearxNG instance. This should include the protocol (e.g., `https://`) and the domain or IP address where SearxNG is hosted.+- `base_url` (str): The base URL of the SearXNG instance. This should include the protocol (e.g., `https://`) and the domain or IP address where SearXNG is hosted.- `max_results` (int, optional): The maximum number of search results to return. Defaults to `10`.### Example```python-config = SearxNGSearchToolConfig(+config = SearXNGSearchToolConfig(base_url="https://searxng.example.com",max_results=5)@@ -38,10 +38,10 @@ config = SearxNGSearchToolConfig(- `category` (Optional[Literal["general", "news", "social_media"]]): Category of the search queries. Defaults to "general".### Output Schema-- `results` (List[SearxNGSearchResultItemSchema]): List of search result items.+- `results` (List[SearXNGSearchResultItemSchema]): List of search result items.- `category` (Optional[str]): The category of the search results.-Each `SearxNGSearchResultItemSchema` contains:+Each `SearXNGSearchResultItemSchema` contains:- `url` (str): The URL of the search result.- `title` (str): The title of the search result.- `content` (Optional[str]): The content snippet of the search result.@@ -49,19 +49,19 @@ Each `SearxNGSearchResultItemSchema` contains:## Usage-Here's an example of how to use the SearxNG Search Tool:+Here's an example of how to use the SearXNG Search Tool:```pythonimport os-from tool.searxng_search import SearxNGTool, SearxNGSearchToolConfig+from tool.searxng_search import SearXNGTool, SearXNGSearchToolConfig-# Initialize the tool with your SearxNG instance URL-config = SearxNGSearchToolConfig(base_url=os.getenv("SEARXNG_BASE_URL"), max_results=5)-search_tool = SearxNGTool(config=config)+# Initialize the tool with your SearXNG instance URL+config = SearXNGSearchToolConfig(base_url=os.getenv("SEARXNG_BASE_URL"), max_results=5)+search_tool = SearXNGTool(config=config)# Define input data-input_data = SearxNGTool.input_schema(+input_data = SearXNGTool.input_schema(queries=["Python programming", "Machine learning", "Artificial intelligence"],category="news")diff --git a/atomic-forge/tools/searxng_search/tests/test_searxng_search.py b/atomic-forge/tools/searxng_search/tests/test_searxng_search.pyindex adf643d..721247f 100644--- a/atomic-forge/tools/searxng_search/tests/test_searxng_search.py+++ b/atomic-forge/tools/searxng_search/tests/test_searxng_search.py@@ -7,10 +7,10 @@ from aiohttp import ClientSessionsys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "..")))from tool.searxng_search import ( # noqa: E402- SearxNGSearchTool,- SearxNGSearchToolInputSchema,- SearxNGSearchToolOutputSchema,- SearxNGSearchToolConfig,+ SearXNGSearchTool,+ SearXNGSearchToolInputSchema,+ SearXNGSearchToolOutputSchema,+ SearXNGSearchToolConfig,)@@ -49,14 +49,14 @@ async def test_searxng_search_tool_with_category(mock_aiohttp_session):mock_aiohttp_session.get.return_value.__aenter__.return_value = mock_response# Initialize the tool- searxng_tool = SearxNGSearchTool(SearxNGSearchToolConfig(base_url=mock_searxng_url))- input_schema = SearxNGSearchToolInputSchema(queries=[mock_query], category="news")+ searxng_tool = SearXNGSearchTool(SearXNGSearchToolConfig(base_url=mock_searxng_url))+ input_schema = SearXNGSearchToolInputSchema(queries=[mock_query], category="news")# Run the toolresult = await searxng_tool.run_async(input_schema)# Assertions- assert isinstance(result, SearxNGSearchToolOutputSchema)+ assert isinstance(result, SearXNGSearchToolOutputSchema)assert len(result.results) == 1assert result.results[0].title == "Test Result with Category"assert result.results[0].url == "https://example.com/test-category"@@ -87,8 +87,8 @@ async def test_searxng_search_tool_missing_fields(mock_aiohttp_session):mock_aiohttp_session.get.return_value.__aenter__.return_value = mock_response# Initialize the tool- searxng_tool = SearxNGSearchTool(SearxNGSearchToolConfig(base_url=mock_searxng_url))- input_schema = SearxNGSearchToolInputSchema(queries=[mock_query], category=None)+ searxng_tool = SearXNGSearchTool(SearXNGSearchToolConfig(base_url=mock_searxng_url))+ input_schema = SearXNGSearchToolInputSchema(queries=[mock_query], category=None)# Run the toolresult = await searxng_tool.run_async(input_schema)@@ -137,8 +137,8 @@ async def test_searxng_search_tool_with_metadata_and_published_date(mock_aiohttpmock_aiohttp_session.get.return_value.__aenter__.return_value = mock_response# Initialize the tool- searxng_tool = SearxNGSearchTool(SearxNGSearchToolConfig(base_url=mock_searxng_url))- input_schema = SearxNGSearchToolInputSchema(queries=[mock_query], category=None)+ searxng_tool = SearXNGSearchTool(SearXNGSearchToolConfig(base_url=mock_searxng_url))+ input_schema = SearXNGSearchToolInputSchema(queries=[mock_query], category=None)# Run the toolresult = await searxng_tool.run_async(input_schema)@@ -173,8 +173,8 @@ def test_searxng_search_tool_sync_run_method(mock_aiohttp_session):mock_aiohttp_session.get.return_value.__aenter__.return_value = mock_response# Initialize the tool- searxng_tool = SearxNGSearchTool(SearxNGSearchToolConfig(base_url=mock_searxng_url))- input_schema = SearxNGSearchToolInputSchema(queries=[mock_query], category=None)+ searxng_tool = SearXNGSearchTool(SearXNGSearchToolConfig(base_url=mock_searxng_url))+ input_schema = SearXNGSearchToolInputSchema(queries=[mock_query], category=None)# Run the tool synchronouslyresult = searxng_tool.run(input_schema)@@ -204,8 +204,8 @@ async def test_searxng_search_tool_with_max_results(mock_aiohttp_session):mock_aiohttp_session.get.return_value.__aenter__.return_value = mock_response# Initialize the tool- searxng_tool = SearxNGSearchTool(SearxNGSearchToolConfig(base_url=mock_searxng_url, max_results=10))- input_schema = SearxNGSearchToolInputSchema(queries=[mock_query], category=None)+ searxng_tool = SearXNGSearchTool(SearXNGSearchToolConfig(base_url=mock_searxng_url, max_results=10))+ input_schema = SearXNGSearchToolInputSchema(queries=[mock_query], category=None)# Run the tool with max_results=5result = await searxng_tool.run_async(input_schema, max_results=5)@@ -230,8 +230,8 @@ async def test_searxng_search_tool_no_results(mock_aiohttp_session):mock_aiohttp_session.get.return_value.__aenter__.return_value = mock_response# Initialize the tool- searxng_tool = SearxNGSearchTool(SearxNGSearchToolConfig(base_url=mock_searxng_url))- input_schema = SearxNGSearchToolInputSchema(queries=[mock_query], category=None)+ searxng_tool = SearXNGSearchTool(SearXNGSearchToolConfig(base_url=mock_searxng_url))+ input_schema = SearXNGSearchToolInputSchema(queries=[mock_query], category=None)# Run the toolresult = await searxng_tool.run_async(input_schema)@@ -255,8 +255,8 @@ async def test_searxng_search_tool_error(mock_aiohttp_session):mock_aiohttp_session.get.return_value.__aenter__.return_value = mock_response# Initialize the tool- searxng_tool = SearxNGSearchTool(SearxNGSearchToolConfig(base_url=mock_searxng_url))- input_schema = SearxNGSearchToolInputSchema(queries=[mock_query], category=None)+ searxng_tool = SearXNGSearchTool(SearXNGSearchToolConfig(base_url=mock_searxng_url))+ input_schema = SearXNGSearchToolInputSchema(queries=[mock_query], category=None)# Run the tool and expect an exceptionwith pytest.raises(Exception) as excinfo:diff --git a/atomic-forge/tools/searxng_search/tool/searxng_search.py b/atomic-forge/tools/searxng_search/tool/searxng_search.pyindex e874377..ccd0267 100644--- a/atomic-forge/tools/searxng_search/tool/searxng_search.py+++ b/atomic-forge/tools/searxng_search/tool/searxng_search.py@@ -13,9 +13,9 @@ from atomic_agents.lib.base.base_tool import BaseTool, BaseToolConfig################# INPUT SCHEMA #################-class SearxNGSearchToolInputSchema(BaseIOSchema):+class SearXNGSearchToolInputSchema(BaseIOSchema):"""- Schema for input to a tool for searching for information, news, references, and other content using SearxNG.+ Schema for input to a tool for searching for information, news, references, and other content using SearXNG.Returns a list of search results with a short description or content snippet and URLs for further exploration"""@@ -28,7 +28,7 @@ class SearxNGSearchToolInputSchema(BaseIOSchema):##################### OUTPUT SCHEMA(S) #####################-class SearxNGSearchResultItemSchema(BaseIOSchema):+class SearXNGSearchResultItemSchema(BaseIOSchema):"""This schema represents a single search result item"""url: str = Field(..., description="The URL of the search result")@@ -37,38 +37,38 @@ class SearxNGSearchResultItemSchema(BaseIOSchema):query: str = Field(..., description="The query used to obtain this search result")-class SearxNGSearchToolOutputSchema(BaseIOSchema):- """This schema represents the output of the SearxNG search tool."""+class SearXNGSearchToolOutputSchema(BaseIOSchema):+ """This schema represents the output of the SearXNG search tool."""- results: List[SearxNGSearchResultItemSchema] = Field(..., description="List of search result items")+ results: List[SearXNGSearchResultItemSchema] = Field(..., description="List of search result items")category: Optional[str] = Field(None, description="The category of the search results")############### TOOL LOGIC ###############-class SearxNGSearchToolConfig(BaseToolConfig):+class SearXNGSearchToolConfig(BaseToolConfig):base_url: str = ""max_results: int = 10-class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolOutputSchema]):+class SearXNGSearchTool(BaseTool[SearXNGSearchToolInputSchema, SearXNGSearchToolOutputSchema]):"""- Tool for performing searches on SearxNG based on the provided queries and category.+ Tool for performing searches on SearXNG based on the provided queries and category.Attributes:- input_schema (SearxNGSearchToolInputSchema): The schema for the input data.- output_schema (SearxNGSearchToolOutputSchema): The schema for the output data.+ input_schema (SearXNGSearchToolInputSchema): The schema for the input data.+ output_schema (SearXNGSearchToolOutputSchema): The schema for the output data.max_results (int): The maximum number of search results to return.- base_url (str): The base URL for the SearxNG instance to use.+ base_url (str): The base URL for the SearXNG instance to use."""- def __init__(self, config: SearxNGSearchToolConfig = SearxNGSearchToolConfig()):+ def __init__(self, config: SearXNGSearchToolConfig = SearXNGSearchToolConfig()):"""- Initializes the SearxNGTool.+ Initializes the SearXNGTool.Args:- config (SearxNGSearchToolConfig):+ config (SearXNGSearchToolConfig):Configuration for the tool, including base URL, max results, and optional title and description overrides."""super().__init__(config)@@ -88,7 +88,7 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolList[dict]: A list of search result dictionaries.Raises:- Exception: If the request to SearxNG fails.+ Exception: If the request to SearXNG fails."""query_params = {"q": query,@@ -114,21 +114,21 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolreturn resultsasync def run_async(- self, params: SearxNGSearchToolInputSchema, max_results: Optional[int] = None- ) -> SearxNGSearchToolOutputSchema:+ self, params: SearXNGSearchToolInputSchema, max_results: Optional[int] = None+ ) -> SearXNGSearchToolOutputSchema:"""- Runs the SearxNGTool asynchronously with the given parameters.+ Runs the SearXNGTool asynchronously with the given parameters.Args:- params (SearxNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.+ params (SearXNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.max_results (Optional[int]): The maximum number of search results to return.Returns:- SearxNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.+ SearXNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.Raises:ValueError: If the base URL is not provided.- Exception: If the request to SearxNG fails.+ Exception: If the request to SearXNG fails."""async with aiohttp.ClientSession() as session:tasks = [self._fetch_search_results(session, query, params.category) for query in params.queries]@@ -161,9 +161,9 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolfiltered_results = filtered_results[: max_results or self.max_results]- return SearxNGSearchToolOutputSchema(+ return SearXNGSearchToolOutputSchema(results=[- SearxNGSearchResultItemSchema(+ SearXNGSearchResultItemSchema(url=result["url"], title=result["title"], content=result.get("content"), query=result["query"])for result in filtered_results@@ -171,22 +171,22 @@ class SearxNGSearchTool(BaseTool[SearxNGSearchToolInputSchema, SearxNGSearchToolcategory=params.category,)- def run(self, params: SearxNGSearchToolInputSchema, max_results: Optional[int] = None) -> SearxNGSearchToolOutputSchema:+ def run(self, params: SearXNGSearchToolInputSchema, max_results: Optional[int] = None) -> SearXNGSearchToolOutputSchema:"""- Runs the SearxNGTool synchronously with the given parameters.+ Runs the SearXNGTool synchronously with the given parameters.This method creates an event loop in a separate thread to run the asynchronous operations.Args:- params (SearxNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.+ params (SearXNGSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.max_results (Optional[int]): The maximum number of search results to return.Returns:- SearxNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.+ SearXNGSearchToolOutputSchema: The output of the tool, adhering to the output schema.Raises:ValueError: If the base URL is not provided.- Exception: If the request to SearxNG fails.+ Exception: If the request to SearXNG fails."""with ThreadPoolExecutor() as executor:return executor.submit(asyncio.run, self.run_async(params, max_results)).result()@@ -202,11 +202,11 @@ if __name__ == "__main__":load_dotenv()rich_console = Console()- search_tool_instance = SearxNGSearchTool(- config=SearxNGSearchToolConfig(base_url=os.getenv("SEARXNG_BASE_URL"), max_results=5)+ search_tool_instance = SearXNGSearchTool(+ config=SearXNGSearchToolConfig(base_url=os.getenv("SEARXNG_BASE_URL"), max_results=5))- search_input = SearxNGSearchTool.input_schema(+ search_input = SearXNGSearchTool.input_schema(queries=["Python programming", "Machine learning", "Artificial intelligence"],category="news",)diff --git a/docs/guides/tools.md b/docs/guides/tools.mdindex 8cd6067..a7afc91 100644--- a/docs/guides/tools.md+++ b/docs/guides/tools.md@@ -15,7 +15,7 @@ The Atomic Forge approach provides several key benefits:The Atomic Forge includes several pre-built tools:- **Calculator**: Perform mathematical calculations-- **SearxNG Search**: Search the web using SearxNG+- **SearXNG Search**: Search the web using SearXNG- **Tavily Search**: AI-powered web search- **YouTube Transcript Scraper**: Extract transcripts from YouTube videos- **Webpage Scraper**: Extract content from web pages