# ADK Extra Services
[](LICENSE)
[](https://github.com/edu010101/adk-extra-services/actions/workflows/ci.yml)
> Extensions and additional services for the [Agent Development Kit (ADK)](https://github.com/google/adk-python)
ADK Extra Services provides production-ready implementations of common services needed for building robust AI agents with the Google ADK framework.
## 🚀 Installation
```bash
pip install adk-extra-services
```
## 🛠️ Development Setup
If you want to contribute to the project or modify the source code, follow these steps:
1. Clone the repository:
```bash
git clone https://github.com/edu010101/adk-extra-services.git
cd adk-extra-services
```
2. Check out our [Contributing Guidelines](CONTRIBUTING.md) for detailed setup instructions and development workflow.
## 📖 Services
### 🔄 [Sessions](examples/sessions/README.md)
Persistent session storage implementations for ADK agents.
#### Available Services:
- **MongoDBSessionService**: Persistent session storage using MongoDB
```python
from adk_extra_services.sessions import MongoSessionService
mongo_service = MongoSessionService(
mongo_url="mongodb://your_mongo_uri:your_mongo_port",
db_name="adk_test"
)
```
- **RedisSessionService**: High-performance session storage using Redis
```python
from adk_extra_services.sessions import RedisSessionService
redis_service = RedisSessionService(redis_url="redis://your_redis_uri:your_redis_port")
```
For complete usage examples and API documentation, see the [Sessions Guide](examples/sessions/README.md).
### 📦 [Artifacts](examples/artifacts/README.md)
Storage and management of agent artifacts.
#### Available Services:
- **S3ArtifactService**: Store and manage artifacts in AWS S3 or compatible storage (Compatible with MinIO, DigitalOcean Spaces, Wasabi, Backblaze B2, and others)
```python
from adk_extra_services.artifacts import S3ArtifactService
s3_artifact_service = S3ArtifactService(
bucket_name="your_bucket_name",
endpoint_url="https://{your-bucket-name}.s3.{region}.amazonaws.com",
)
```
- **LocalFolderArtifactService**: Lightweight local-filesystem storage ideal for development & testing environments.
```python
from adk_extra_services.artifacts import LocalFolderArtifactService
artifact_service = LocalFolderArtifactService(base_path="./artifacts_storage")
```
- **AzureBlobArtifactService**: Store and manage artifacts in Azure Blob Storage
```python
from adk_extra_services.artifacts import AzureBlobArtifactService
from azure.core.credentials import AzureSasCredential
azure_service = AzureBlobArtifactService(
account_url="https://yourstorageaccount.blob.core.windows.net",
container_name="your-container-name",
credential=AzureSasCredential("your-sas-token"),
ensure_container=True,
)
```
For complete usage examples and API documentation, see the [Artifacts Guide](examples/artifacts/README.md).
## 🤝 Contributing
Contributions are welcome! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.
## 📄 License
This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "adk-extra-services",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "adk, google-adk, s3, amazon-s3, artifact-storage, session-service, redis, mongo",
"author": null,
"author_email": "edu010101 <eduardo@geoia.tech>",
"download_url": "https://files.pythonhosted.org/packages/96/99/b0d4457f990d2c44957ea626804fcbd5d5eb59d26a7a8d4196123b1e3465/adk_extra_services-0.1.6.tar.gz",
"platform": null,
"description": "# ADK Extra Services\n\n[](LICENSE)\n[](https://github.com/edu010101/adk-extra-services/actions/workflows/ci.yml)\n\n> Extensions and additional services for the [Agent Development Kit (ADK)](https://github.com/google/adk-python)\n\nADK Extra Services provides production-ready implementations of common services needed for building robust AI agents with the Google ADK framework.\n\n## \ud83d\ude80 Installation\n\n```bash\npip install adk-extra-services\n```\n\n## \ud83d\udee0\ufe0f Development Setup\n\nIf you want to contribute to the project or modify the source code, follow these steps:\n\n1. Clone the repository:\n ```bash\n git clone https://github.com/edu010101/adk-extra-services.git\n cd adk-extra-services\n ```\n\n2. Check out our [Contributing Guidelines](CONTRIBUTING.md) for detailed setup instructions and development workflow.\n\n\n## \ud83d\udcd6 Services\n\n### \ud83d\udd04 [Sessions](examples/sessions/README.md)\n\nPersistent session storage implementations for ADK agents.\n\n#### Available Services:\n- **MongoDBSessionService**: Persistent session storage using MongoDB\n ```python\n from adk_extra_services.sessions import MongoSessionService\n\n mongo_service = MongoSessionService(\n mongo_url=\"mongodb://your_mongo_uri:your_mongo_port\",\n db_name=\"adk_test\"\n )\n ```\n\n- **RedisSessionService**: High-performance session storage using Redis\n ```python\n from adk_extra_services.sessions import RedisSessionService\n\n redis_service = RedisSessionService(redis_url=\"redis://your_redis_uri:your_redis_port\")\n ```\n\nFor complete usage examples and API documentation, see the [Sessions Guide](examples/sessions/README.md).\n\n### \ud83d\udce6 [Artifacts](examples/artifacts/README.md)\n\nStorage and management of agent artifacts.\n\n#### Available Services:\n- **S3ArtifactService**: Store and manage artifacts in AWS S3 or compatible storage (Compatible with MinIO, DigitalOcean Spaces, Wasabi, Backblaze B2, and others)\n\n ```python\n from adk_extra_services.artifacts import S3ArtifactService\n\n s3_artifact_service = S3ArtifactService(\n bucket_name=\"your_bucket_name\",\n endpoint_url=\"https://{your-bucket-name}.s3.{region}.amazonaws.com\",\n )\n \n ```\n\n- **LocalFolderArtifactService**: Lightweight local-filesystem storage ideal for development & testing environments.\n\n ```python\n from adk_extra_services.artifacts import LocalFolderArtifactService\n\n artifact_service = LocalFolderArtifactService(base_path=\"./artifacts_storage\")\n ```\n\n- **AzureBlobArtifactService**: Store and manage artifacts in Azure Blob Storage\n\n ```python\n from adk_extra_services.artifacts import AzureBlobArtifactService\n from azure.core.credentials import AzureSasCredential\n\n azure_service = AzureBlobArtifactService(\n account_url=\"https://yourstorageaccount.blob.core.windows.net\",\n container_name=\"your-container-name\",\n credential=AzureSasCredential(\"your-sas-token\"),\n ensure_container=True,\n )\n ```\n\nFor complete usage examples and API documentation, see the [Artifacts Guide](examples/artifacts/README.md).\n\n## \ud83e\udd1d Contributing\n\nContributions are welcome! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Additional service implementations for Google ADK",
"version": "0.1.6",
"project_urls": {
"Documentation": "https://github.com/edu010101/adk-extra-services#readme",
"Homepage": "https://github.com/edu010101/adk-extra-services",
"Source": "https://github.com/edu010101/adk-extra-services"
},
"split_keywords": [
"adk",
" google-adk",
" s3",
" amazon-s3",
" artifact-storage",
" session-service",
" redis",
" mongo"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "55a3d61c85b8e5755997224afa9f293fe0521ab29561603d66772b94dd5fea2f",
"md5": "ae920beb5075979bdff9cf1f5d826e17",
"sha256": "c26363f86ba059c4e32e31db4b665f2a5551710d8875275883a23bc9b7857f12"
},
"downloads": -1,
"filename": "adk_extra_services-0.1.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ae920beb5075979bdff9cf1f5d826e17",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 18424,
"upload_time": "2025-10-07T18:30:00",
"upload_time_iso_8601": "2025-10-07T18:30:00.142919Z",
"url": "https://files.pythonhosted.org/packages/55/a3/d61c85b8e5755997224afa9f293fe0521ab29561603d66772b94dd5fea2f/adk_extra_services-0.1.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9699b0d4457f990d2c44957ea626804fcbd5d5eb59d26a7a8d4196123b1e3465",
"md5": "6b7ea1605fd530f8f48fd669f1687f72",
"sha256": "a0e4372a7fec9a7154b7a6b646a84d8770258fc71be3aa0011e369006d3493dd"
},
"downloads": -1,
"filename": "adk_extra_services-0.1.6.tar.gz",
"has_sig": false,
"md5_digest": "6b7ea1605fd530f8f48fd669f1687f72",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 20136,
"upload_time": "2025-10-07T18:30:01",
"upload_time_iso_8601": "2025-10-07T18:30:01.405883Z",
"url": "https://files.pythonhosted.org/packages/96/99/b0d4457f990d2c44957ea626804fcbd5d5eb59d26a7a8d4196123b1e3465/adk_extra_services-0.1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-07 18:30:01",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "edu010101",
"github_project": "adk-extra-services#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "adk-extra-services"
}
JSON
