# Bolt Agent Toolkit - Python
The Bolt Agent Toolkit library provides a BoltAPI tool for integrating with Bolt APIs through function calling. This library is not exhaustive of the entire Bolt API. It is built directly on top of the [Bolt Python SDK][python-sdk].
## Installation (Coming soon)
### Requirements
- [uv][uv-install]
## Usage
## Bolt API
The library needs to be configured with your account's API key which is
available in your [Bolt Dashboard][api-keys].
```python
from bolt_agent_toolkit import BoltAPI, Context
api_key = "your_bolt_api_key"
context = Context(
api_key=api_key,
publishable_key="your_bolt_publishable_key",
)
bolt_api = BoltAPI(api_key=api_key, context=context)
products_result = bolt_api.list_products()
print(products_result)
```
## OpenAI
```python
from bolt_agent_toolkit.openai.toolkit import BoltAgentToolkit
```
## Langchain
```python
from bolt_agent_toolkit.langchain.toolkit import BoltAgentToolkit
bolt_agent_toolkit = BoltAgentToolkit(
api_key="your_bolt_api_key",
configuration={
configuration={
"context": {
"publishable_key": publishable_key,
},
},
"actions": {
"products": {
"read": True,
},
},
},
)
```
## Development
This project uses a Makefile to simplify common development tasks. To see all available targets and their descriptions:
```bash
make
```
### Quick Start
```bash
# Set up the development environment
make setup
# Run tests
make test
# Format and lint code
make lint
# Build the package
make build
# Clean up generated files
make clean
```
### Manual Commands
If you prefer to use `uv` directly:
```bash
# Set up environment and install dependencies
uv sync
# Run tests
uv run -m pytest tests/ -v
# Run individual tools
uv run black bolt_agent_toolkit/
uv run mypy bolt_agent_toolkit/
```
[python-sdk]: https://github.com/BoltApp/Bolt-Python-SDK
[api-keys]: https://merchant.bolt.com/administration/api-keys
[uv-install]: https://docs.astral.sh/uv/getting-started/installation/
Raw data
{
"_id": null,
"home_page": null,
"name": "bolt-agent-toolkit",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "bolt, mcp, modelcontextprotocol",
"author": null,
"author_email": "Bolt <support@bolt.com>",
"download_url": "https://files.pythonhosted.org/packages/89/84/ef8c20c0434cf3fb79663f7953c4f003fbbf3ae536786074a514aa666fa3/bolt_agent_toolkit-0.1.0.tar.gz",
"platform": null,
"description": "# Bolt Agent Toolkit - Python\n\nThe Bolt Agent Toolkit library provides a BoltAPI tool for integrating with Bolt APIs through function calling. This library is not exhaustive of the entire Bolt API. It is built directly on top of the [Bolt Python SDK][python-sdk].\n\n## Installation (Coming soon)\n\n### Requirements\n\n- [uv][uv-install]\n\n## Usage\n\n## Bolt API\n\nThe library needs to be configured with your account's API key which is\navailable in your [Bolt Dashboard][api-keys].\n\n```python\nfrom bolt_agent_toolkit import BoltAPI, Context\n\napi_key = \"your_bolt_api_key\"\ncontext = Context(\n api_key=api_key,\n publishable_key=\"your_bolt_publishable_key\",\n)\n\nbolt_api = BoltAPI(api_key=api_key, context=context)\n\nproducts_result = bolt_api.list_products()\nprint(products_result)\n```\n\n## OpenAI\n\n```python\nfrom bolt_agent_toolkit.openai.toolkit import BoltAgentToolkit\n```\n\n## Langchain\n\n```python\nfrom bolt_agent_toolkit.langchain.toolkit import BoltAgentToolkit\n\nbolt_agent_toolkit = BoltAgentToolkit(\n api_key=\"your_bolt_api_key\",\n configuration={\n configuration={\n \"context\": {\n \"publishable_key\": publishable_key,\n },\n },\n \"actions\": {\n \"products\": {\n \"read\": True,\n },\n },\n },\n)\n```\n\n## Development\n\nThis project uses a Makefile to simplify common development tasks. To see all available targets and their descriptions:\n\n```bash\nmake\n```\n\n### Quick Start\n\n```bash\n# Set up the development environment\nmake setup\n\n# Run tests\nmake test\n\n# Format and lint code\nmake lint\n\n# Build the package\nmake build\n\n# Clean up generated files\nmake clean\n```\n\n### Manual Commands\n\nIf you prefer to use `uv` directly:\n\n```bash\n# Set up environment and install dependencies\nuv sync\n\n# Run tests\nuv run -m pytest tests/ -v\n\n# Run individual tools\nuv run black bolt_agent_toolkit/\nuv run mypy bolt_agent_toolkit/\n```\n\n[python-sdk]: https://github.com/BoltApp/Bolt-Python-SDK\n[api-keys]: https://merchant.bolt.com/administration/api-keys\n[uv-install]: https://docs.astral.sh/uv/getting-started/installation/\n",
"bugtrack_url": null,
"license": null,
"summary": "Bolt Agent Toolkit",
"version": "0.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/BoltApp/agent-toolkit/issues",
"Source Code": "https://github.com/BoltApp/agent-toolkit/python"
},
"split_keywords": [
"bolt",
" mcp",
" modelcontextprotocol"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "847d4906f3b391a66371f520ab178fe92102052a967a95ac405a1ae5f5b63ead",
"md5": "84e57944fe7788de1de4cb5a6da6c1bb",
"sha256": "b281639e1a9fce6543759660a154b2d46aec235438efc0fc0a677b206ad2af5a"
},
"downloads": -1,
"filename": "bolt_agent_toolkit-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "84e57944fe7788de1de4cb5a6da6c1bb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 18898,
"upload_time": "2025-08-13T02:49:30",
"upload_time_iso_8601": "2025-08-13T02:49:30.364869Z",
"url": "https://files.pythonhosted.org/packages/84/7d/4906f3b391a66371f520ab178fe92102052a967a95ac405a1ae5f5b63ead/bolt_agent_toolkit-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8984ef8c20c0434cf3fb79663f7953c4f003fbbf3ae536786074a514aa666fa3",
"md5": "b56e8af524f1d25e0f05a976a2ad8e38",
"sha256": "a0c1f7f2d3e60ef34759b794029dc54f0419f0d37b9382e10aa4acc86fe6f9c9"
},
"downloads": -1,
"filename": "bolt_agent_toolkit-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "b56e8af524f1d25e0f05a976a2ad8e38",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 165082,
"upload_time": "2025-08-13T02:49:31",
"upload_time_iso_8601": "2025-08-13T02:49:31.499678Z",
"url": "https://files.pythonhosted.org/packages/89/84/ef8c20c0434cf3fb79663f7953c4f003fbbf3ae536786074a514aa666fa3/bolt_agent_toolkit-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-13 02:49:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "BoltApp",
"github_project": "agent-toolkit",
"github_not_found": true,
"lcname": "bolt-agent-toolkit"
}
JSON
