Building AI agents, atomically
chore: use instructor extras for provider SDKs
KennyVaneetvelded4012e5a2c85
diff --git a/README.md b/README.mdindex 5092dbc..8085450 100644--- a/README.md+++ b/README.md@@ -65,12 +65,16 @@ To install Atomic Agents, you can use pip:pip install atomic-agents```-Make sure you also install the provider you want to use. For example, to use OpenAI and Groq, you can install the `openai` and `groq` packages:+Make sure you also install the provider you want to use. Provider SDKs are available as instructor extras:```bash-pip install openai groq+pip install instructor[groq] # for Groq+pip install instructor[anthropic] # for Anthropic+pip install instructor[google-genai] # for Gemini```+OpenAI is included by default. For a full list of supported providers, see the [Instructor docs](https://python.useinstructor.com/integrations/).+This also installs the CLI *Atomic Assembler*, which can be used to download Tools (and soon also Agents and Pipelines).### Quick Examplediff --git a/atomic-examples/basic-multimodal/pyproject.toml b/atomic-examples/basic-multimodal/pyproject.tomlindex 11a1f5a..939758a 100644--- a/atomic-examples/basic-multimodal/pyproject.toml+++ b/atomic-examples/basic-multimodal/pyproject.toml@@ -18,9 +18,6 @@ dependencies = ["atomic-agents","instructor==1.14.5","openai>=2.0.0,<3.0.0",- "groq>=0.11.0,<1.0.0",- "mistralai>=1.1.0,<2.0.0",- "anthropic>=0.39.0,<1.0.0",][tool.uv.sources]diff --git a/atomic-examples/basic-pdf-analysis/pyproject.toml b/atomic-examples/basic-pdf-analysis/pyproject.tomlindex efa3139..81fb646 100644--- a/atomic-examples/basic-pdf-analysis/pyproject.toml+++ b/atomic-examples/basic-pdf-analysis/pyproject.toml@@ -16,9 +16,7 @@ authors = [requires-python = ">=3.12,<3.14"dependencies = ["atomic-agents",- "instructor==1.14.5",- "google-genai>=1.18.0,<2.0.0",- "jsonref>=1.1.0,<2.0.0",+ "instructor[google-genai]==1.14.5",][tool.uv.sources]diff --git a/atomic-examples/quickstart/pyproject.toml b/atomic-examples/quickstart/pyproject.tomlindex 323d493..7488832 100644--- a/atomic-examples/quickstart/pyproject.toml+++ b/atomic-examples/quickstart/pyproject.toml@@ -16,13 +16,8 @@ authors = [requires-python = ">=3.12"dependencies = ["atomic-agents",- "instructor==1.14.5",+ "instructor[anthropic,groq,google-genai]==1.14.5","openai>=2.0.0,<3.0.0",- "groq>=0.11.0,<1.0.0",- "mistralai>=1.1.0,<2.0.0",- "anthropic>=0.39.0,<1.0.0",- "google-genai>=1.0.0",- "jsonref>=1.1.0,<2.0.0","python-dotenv>=1.0.1,<2.0.0",]diff --git a/docs/guides/cookbook.md b/docs/guides/cookbook.mdindex 6f0b54a..177371b 100644--- a/docs/guides/cookbook.md+++ b/docs/guides/cookbook.md@@ -293,7 +293,7 @@ Multi-Provider Agent RecipeAgent that can use different LLM providers based on configuration.Requirements:-- pip install atomic-agents openai anthropic groq+- pip install atomic-agents instructor[anthropic,groq]- Set API keys for providers you want to use"""diff --git a/docs/guides/faq.md b/docs/guides/faq.mdindex a227a8e..1f13885 100644--- a/docs/guides/faq.md+++ b/docs/guides/faq.md@@ -18,17 +18,17 @@ Or using uv (recommended):uv add atomic-agents```-You also need to install your LLM provider:+You also need to install your LLM provider. OpenAI is included by default. For other providers, use instructor extras:```bash-# For OpenAI-pip install openai-# For Anthropic-pip install anthropic+pip install instructor[anthropic]# For Groq-pip install groq+pip install instructor[groq]++# For Gemini+pip install instructor[google-genai]```### What Python version is required?diff --git a/docs/index.md b/docs/index.mdindex d882de5..0e5b3f9 100644--- a/docs/index.md+++ b/docs/index.md@@ -56,12 +56,16 @@ Or using uv (recommended):uv add atomic-agents```-Make sure you also install the provider you want to use. For example, to use OpenAI and Groq:+Make sure you also install the provider you want to use. Provider SDKs are available as instructor extras:```bash-pip install openai groq+pip install instructor[groq] # for Groq+pip install instructor[anthropic] # for Anthropic+pip install instructor[google-genai] # for Gemini```+OpenAI is included by default.+This also installs the CLI *Atomic Assembler*, which can be used to download Tools (and soon also Agents and Pipelines).```{note}diff --git a/uv.lock b/uv.lockindex 9a899ed..5132d9f 100644--- a/uv.lock+++ b/uv.lock@@ -149,7 +149,7 @@ wheels = [[[package]]name = "anthropic"-version = "0.75.0"+version = "0.71.0"source = { registry = "https://pypi.org/simple" }dependencies = [{ name = "anyio" },@@ -161,9 +161,9 @@ dependencies = [{ name = "sniffio" },{ name = "typing-extensions" },]-sdist = { url = "https://files.pythonhosted.org/packages/04/1f/08e95f4b7e2d35205ae5dcbb4ae97e7d477fc521c275c02609e2931ece2d/anthropic-0.75.0.tar.gz", hash = "sha256:e8607422f4ab616db2ea5baacc215dd5f028da99ce2f022e33c7c535b29f3dfb", size = 439565, upload-time = "2025-11-24T20:41:45.28Z" }+sdist = { url = "https://files.pythonhosted.org/packages/82/4f/70682b068d897841f43223df82d96ec1d617435a8b759c4a2d901a50158b/anthropic-0.71.0.tar.gz", hash = "sha256:eb8e6fa86d049061b3ef26eb4cbae0174ebbff21affa6de7b3098da857d8de6a", size = 489102, upload-time = "2025-10-16T15:54:40.08Z" }wheels = [- { url = "https://files.pythonhosted.org/packages/60/1c/1cd02b7ae64302a6e06724bf80a96401d5313708651d277b1458504a1730/anthropic-0.75.0-py3-none-any.whl", hash = "sha256:ea8317271b6c15d80225a9f3c670152746e88805a7a61e14d4a374577164965b", size = 388164, upload-time = "2025-11-24T20:41:43.587Z" },+ { url = "https://files.pythonhosted.org/packages/5d/77/073e8ac488f335aec7001952825275582fb8f433737e90f24eeef9d878f6/anthropic-0.71.0-py3-none-any.whl", hash = "sha256:85c5015fcdbdc728390f11b17642a65a4365d03b12b799b18b6cc57e71fdb327", size = 355035, upload-time = "2025-10-16T15:54:38.238Z" },][[package]]@@ -309,21 +309,15 @@ name = "basic-multimodal"version = "1.0.0"source = { editable = "atomic-examples/basic-multimodal" }dependencies = [- { name = "anthropic" },{ name = "atomic-agents" },- { name = "groq" },{ name = "instructor" },- { name = "mistralai" },{ name = "openai" },][package.metadata]requires-dist = [- { name = "anthropic", specifier = ">=0.39.0,<1.0.0" },{ name = "atomic-agents", editable = "." },- { name = "groq", specifier = ">=0.11.0,<1.0.0" },{ name = "instructor", specifier = "==1.14.5" },- { name = "mistralai", specifier = ">=1.1.0,<2.0.0" },{ name = "openai", specifier = ">=2.0.0,<3.0.0" },]@@ -333,17 +327,13 @@ version = "1.0.0"source = { editable = "atomic-examples/basic-pdf-analysis" }dependencies = [{ name = "atomic-agents" },- { name = "google-genai" },- { name = "instructor" },- { name = "jsonref" },+ { name = "instructor", extra = ["google-genai"] },][package.metadata]requires-dist = [{ name = "atomic-agents", editable = "." },- { name = "google-genai", specifier = ">=1.18.0,<2.0.0" },- { name = "instructor", specifier = "==1.14.5" },- { name = "jsonref", specifier = ">=1.1.0,<2.0.0" },+ { name = "instructor", extras = ["google-genai"], specifier = "==1.14.5" },][[package]]@@ -1064,15 +1054,6 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/de/15/545e2b6cf2e3be84bc1ed85613edd75b8aea69807a71c26f4ca6a9258e82/email_validator-2.3.0-py3-none-any.whl", hash = "sha256:80f13f623413e6b197ae73bb10bf4eb0908faf509ad8362c5edeb0be7fd450b4", size = 35604, upload-time = "2025-08-26T13:09:05.858Z" },]-[[package]]-name = "eval-type-backport"-version = "0.3.0"-source = { registry = "https://pypi.org/simple" }-sdist = { url = "https://files.pythonhosted.org/packages/51/23/079e39571d6dd8d90d7a369ecb55ad766efb6bae4e77389629e14458c280/eval_type_backport-0.3.0.tar.gz", hash = "sha256:1638210401e184ff17f877e9a2fa076b60b5838790f4532a21761cc2be67aea1", size = 9272, upload-time = "2025-11-13T20:56:50.845Z" }-wheels = [- { url = "https://files.pythonhosted.org/packages/19/d8/2a1c638d9e0aa7e269269a1a1bf423ddd94267f1a01bbe3ad03432b67dd4/eval_type_backport-0.3.0-py3-none-any.whl", hash = "sha256:975a10a0fe333c8b6260d7fdb637698c9a16c3a9e3b6eb943fee6a6f67a37fe8", size = 6061, upload-time = "2025-11-13T20:56:49.499Z" },-]-[[package]]name = "example-client"version = "0.1.0"@@ -1474,7 +1455,7 @@ wheels = [[[package]]name = "groq"-version = "0.36.0"+version = "0.33.0"source = { registry = "https://pypi.org/simple" }dependencies = [{ name = "anyio" },@@ -1484,9 +1465,9 @@ dependencies = [{ name = "sniffio" },{ name = "typing-extensions" },]-sdist = { url = "https://files.pythonhosted.org/packages/27/83/932f29aee838dac4ab77d5249c886159f88e157f925de214681cd54b0a1c/groq-0.36.0.tar.gz", hash = "sha256:766fa1ae34918552c6488767b16d4bd0ee3f0fb7809cd9f7760c90d13f32c63a", size = 144596, upload-time = "2025-11-20T02:30:05.446Z" }+sdist = { url = "https://files.pythonhosted.org/packages/eb/51/b85f8100078a4802340e8325af2bfa357e3e8d367f11ee8fd83dc3441523/groq-0.33.0.tar.gz", hash = "sha256:5342158026a1f6bf58653d774696f47ef1d763c401e20f9dbc9598337859523a", size = 142470, upload-time = "2025-10-21T01:38:49.913Z" }wheels = [- { url = "https://files.pythonhosted.org/packages/27/79/28f295d5064750674014f50e3c2daf8dc233964c904d357ac2bd0e33fc31/groq-0.36.0-py3-none-any.whl", hash = "sha256:ac7eeae31a5c2e76d30ea678f0b1a9168ff906c4440f5ec3a42ac74d5b4fdb3c", size = 137279, upload-time = "2025-11-20T02:30:04.336Z" },+ { url = "https://files.pythonhosted.org/packages/99/91/5ecd95278f6f1793bccd9ffa0b6db0d8eb71acda9be9dd0668b162fc2986/groq-0.33.0-py3-none-any.whl", hash = "sha256:ed8c33e55872dea3c7a087741af0c36c2a1a6699a24a34f6cada53e502d3ad75", size = 135782, upload-time = "2025-10-21T01:38:48.855Z" },][[package]]@@ -1801,13 +1782,17 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/45/04/e442e1356c97b03a6d30d2b462f7c0bdfbf207e75f6833815fd1225a75b4/instructor-1.14.5-py3-none-any.whl", hash = "sha256:2a5a31222b008c0989be1cc001e33a237f49506e80ac5833f6d36d7690bae7b1", size = 177445, upload-time = "2026-01-29T14:18:53.641Z" },]-[[package]]-name = "invoke"-version = "2.2.1"-source = { registry = "https://pypi.org/simple" }-sdist = { url = "https://files.pythonhosted.org/packages/de/bd/b461d3424a24c80490313fd77feeb666ca4f6a28c7e72713e3d9095719b4/invoke-2.2.1.tar.gz", hash = "sha256:515bf49b4a48932b79b024590348da22f39c4942dff991ad1fb8b8baea1be707", size = 304762, upload-time = "2025-10-11T00:36:35.172Z" }-wheels = [- { url = "https://files.pythonhosted.org/packages/32/4b/b99e37f88336009971405cbb7630610322ed6fbfa31e1d7ab3fbf3049a2d/invoke-2.2.1-py3-none-any.whl", hash = "sha256:2413bc441b376e5cd3f55bb5d364f973ad8bdd7bf87e53c79de3c11bf3feecc8", size = 160287, upload-time = "2025-10-11T00:36:33.703Z" },+[package.optional-dependencies]+anthropic = [+ { name = "anthropic" },+ { name = "xmltodict" },+]+google-genai = [+ { name = "google-genai" },+ { name = "jsonref" },+]+groq = [+ { name = "groq" },][[package]]@@ -2227,24 +2212,6 @@ wheels = [{ url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" },]-[[package]]-name = "mistralai"-version = "1.9.11"-source = { registry = "https://pypi.org/simple" }-dependencies = [- { name = "eval-type-backport" },- { name = "httpx" },- { name = "invoke" },- { name = "pydantic" },- { name = "python-dateutil" },- { name = "pyyaml" },- { name = "typing-inspection" },-]-sdist = { url = "https://files.pythonhosted.org/packages/5a/8d/d8b7af67a966b6f227024e1cb7287fc19901a434f87a5a391dcfe635d338/mistralai-1.9.11.tar.gz", hash = "sha256:3df9e403c31a756ec79e78df25ee73cea3eb15f86693773e16b16adaf59c9b8a", size = 208051, upload-time = "2025-10-02T15:53:40.473Z" }-wheels = [- { url = "https://files.pythonhosted.org/packages/fe/76/4ce12563aea5a76016f8643eff30ab731e6656c845e9e4d090ef10c7b925/mistralai-1.9.11-py3-none-any.whl", hash = "sha256:7a3dc2b8ef3fceaa3582220234261b5c4e3e03a972563b07afa150e44a25a6d3", size = 442796, upload-time = "2025-10-02T15:53:39.134Z" },-]-[[package]]name = "mmh3"version = "5.2.0"@@ -3466,26 +3433,16 @@ name = "quickstart"version = "1.0.0"source = { editable = "atomic-examples/quickstart" }dependencies = [- { name = "anthropic" },{ name = "atomic-agents" },- { name = "google-genai" },- { name = "groq" },- { name = "instructor" },- { name = "jsonref" },- { name = "mistralai" },+ { name = "instructor", extra = ["anthropic", "google-genai", "groq"] },{ name = "openai" },{ name = "python-dotenv" },][package.metadata]requires-dist = [- { name = "anthropic", specifier = ">=0.39.0,<1.0.0" },{ name = "atomic-agents", editable = "." },- { name = "google-genai", specifier = ">=1.0.0" },- { name = "groq", specifier = ">=0.11.0,<1.0.0" },- { name = "instructor", specifier = "==1.14.5" },- { name = "jsonref", specifier = ">=1.1.0,<2.0.0" },- { name = "mistralai", specifier = ">=1.1.0,<2.0.0" },+ { name = "instructor", extras = ["anthropic", "groq", "google-genai"], specifier = "==1.14.5" },{ name = "openai", specifier = ">=2.0.0,<3.0.0" },{ name = "python-dotenv", specifier = ">=1.0.1,<2.0.0" },]@@ -4502,6 +4459,15 @@ version = "3.2"source = { registry = "https://pypi.org/simple" }sdist = { url = "https://files.pythonhosted.org/packages/47/6a/62e288da7bcda82b935ff0c6cfe542970f04e29c756b0e147251b2fb251f/wget-3.2.zip", hash = "sha256:35e630eca2aa50ce998b9b1a127bb26b30dfee573702782aa982f875e3f16061", size = 10857, upload-time = "2015-10-22T15:26:37.51Z" }+[[package]]+name = "xmltodict"+version = "1.0.4"+source = { registry = "https://pypi.org/simple" }+sdist = { url = "https://files.pythonhosted.org/packages/19/70/80f3b7c10d2630aa66414bf23d210386700aa390547278c789afa994fd7e/xmltodict-1.0.4.tar.gz", hash = "sha256:6d94c9f834dd9e44514162799d344d815a3a4faec913717a9ecbfa5be1bb8e61", size = 26124, upload-time = "2026-02-22T02:21:22.074Z" }+wheels = [+ { url = "https://files.pythonhosted.org/packages/38/34/98a2f52245f4d47be93b580dae5f9861ef58977d73a79eb47c58f1ad1f3a/xmltodict-1.0.4-py3-none-any.whl", hash = "sha256:a4a00d300b0e1c59fc2bfccb53d7b2e88c32f200df138a0dd2229f842497026a", size = 13580, upload-time = "2026-02-22T02:21:21.039Z" },+]+[[package]]name = "xxhash"version = "3.6.0"