Skip to content

Building AI agents, atomically

chore: use instructor extras for provider SDKs

KennyVaneetvelded4012e5a2c85
diff --git a/README.md b/README.md
index 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 Example
diff --git a/atomic-examples/basic-multimodal/pyproject.toml b/atomic-examples/basic-multimodal/pyproject.toml
index 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.toml
index 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.toml
index 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.md
index 6f0b54a..177371b 100644
--- a/docs/guides/cookbook.md
+++ b/docs/guides/cookbook.md
@@ -293,7 +293,7 @@ Multi-Provider Agent Recipe
Agent 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.md
index 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.md
index 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.lock
index 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"