# Cogents-Tools
[](https://github.com/mirasurf/cogents-tools/actions/workflows/ci.yml)
[](https://pypi.org/project/cogents-tools/)
[](https://deepwiki.com/mirasurf/cogents-tools)
This is part of [project Cogents](https://github.com/mirasurf/cogents), an initiative to develop a cognitive, computation-driven agentic system. This repo is built upon [cogents-core](https://github.com/mirasurf/cogents-core) and hosts an extensive and extendable list of integrated services, well-tested toolkits, and ready-to-go agents. Our philosophy focuses on a modular, composable design that can be easily integrated into existing systems or used to build new ones from the ground up.
## 🎯 Core Capabilities
Cogents-tools has evolved into a mature, production-ready toolkit ecosystem featuring **advanced lazy loading** and **semantic organization**. The project now offers 17+ specialized toolkits organized into 10 semantic groups, providing comprehensive coverage for cognitive agent development.
#### Extensible Resources & Infrastructure
- **Web Search**: Multi-provider integration (Tavily, Google AI Search, Serper)
- **Vector Stores**: Production-ready backends (Weaviate, PgVector) with semantic search
- **Document Processing**: Intelligent text extraction and chunking for RAG workflows
- **Voice Processing**: Advanced transcription and audio analysis capabilities
#### Toolkit Ecosystem (17+ Tools)
- **Academic Research**: arXiv integration for paper discovery and analysis
- **Development Tools**: Bash execution, file editing, GitHub integration, Python execution
- **Media Processing**: Image analysis, video processing, audio transcription
- **Information Retrieval**: Wikipedia, web search, and knowledge extraction
- **Data Management**: Tabular data processing, memory systems, document handling
- **Human Interaction**: User communication and feedback collection systems
#### Architecture & Performance
- **Lazy Loading**: Only load what you need, when you need it
- **Semantic Organization**: Intuitive grouping reduces cognitive overhead
- **Async-First Design**: Built for high-performance concurrent operations
- **Extensible Registry**: Easy integration of custom tools and capabilities
- **Error Resilience**: Graceful handling of missing dependencies and failures
## âš¡ Lazy Loading & Performance
Cogents-tools features an advanced **lazy loading system** that dramatically improves import performance and reduces memory usage:
- **🚀 Fast imports**: Only load what you need, when you need it
- **📦 Group-wise loading**: Import semantic groups of related toolkits
- **💾 Memory efficient**: Unused toolkits remain unloaded
- **🔧 Zero configuration**: Lazy loading is enabled by default
### Available Toolkit Groups
| Group | Description | Toolkits |
|-------|-------------|----------|
| `academic` | Academic research tools | arxiv_toolkit |
| `audio` | Audio processing | audio_toolkit, audio_aliyun_toolkit |
| `communication` | Communication & messaging | memory_toolkit |
| `development` | Development tools | bash_toolkit, file_edit_toolkit, github_toolkit, python_executor_toolkit, tabular_data_toolkit |
| `file_processing` | File manipulation | document_toolkit, file_edit_toolkit, tabular_data_toolkit |
| `hitl` | Human-in-the-loop | user_interaction_toolkit |
| `image` | Image processing | image_toolkit |
| `info_retrieval` | Information search | search_toolkit, serper_toolkit, wikipedia_toolkit |
| `persistence` | Data storage | memory_toolkit |
| `video` | Video processing | video_toolkit |
## Install
```bash
pip install -U cogents-tools
```
## 🚀 Quick Examples
### Lazy Loading
```python
import cogents_tools
# Check lazy loading status
print(f"Lazy loading enabled: {cogents_tools.is_lazy_loading_enabled()}")
# Get available groups
print(f"Available groups: {cogents_tools.get_available_groups()}")
# Load specific group
dev_toolkits = cogents_tools.load_toolkit_group('development')
# Monitor loaded modules
print(f"Loaded modules: {cogents_tools.get_loaded_modules()}")
```
### Agent-Tools Integration
TODO
## 📚 Demo Scripts
Explore the capabilities with our comprehensive demo scripts under [examples](./examples) folder.
## Best Practices
1. **Use group imports** for related functionality
2. **Keep lazy loading enabled** unless you have specific requirements
3. **Use the demos** to understand performance characteristics
## License
MIT License - see [LICENSE](LICENSE) file for details.
## Acknowledgment
- Tencent [Youtu-agent](https://github.com/Tencent/Youtu-agent) toolkits integration.
Raw data
{
"_id": null,
"home_page": null,
"name": "cogents-tools",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": "Xiaming Chen <chenxm35@gmail.com>",
"keywords": "agents, multi-agent system, cognition, artificial intelligence",
"author": null,
"author_email": "Xiaming Chen <chenxm35@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/a1/1d/7906ace0f247e2236be760201cdd5275b8321da92fb92f0cd99ebe18b0ba/cogents_tools-0.1.5.3.tar.gz",
"platform": null,
"description": "# Cogents-Tools\n\n[](https://github.com/mirasurf/cogents-tools/actions/workflows/ci.yml)\n[](https://pypi.org/project/cogents-tools/)\n[](https://deepwiki.com/mirasurf/cogents-tools)\n\nThis is part of [project Cogents](https://github.com/mirasurf/cogents), an initiative to develop a cognitive, computation-driven agentic system. This repo is built upon [cogents-core](https://github.com/mirasurf/cogents-core) and hosts an extensive and extendable list of integrated services, well-tested toolkits, and ready-to-go agents. Our philosophy focuses on a modular, composable design that can be easily integrated into existing systems or used to build new ones from the ground up.\n\n## \ud83c\udfaf Core Capabilities\n\nCogents-tools has evolved into a mature, production-ready toolkit ecosystem featuring **advanced lazy loading** and **semantic organization**. The project now offers 17+ specialized toolkits organized into 10 semantic groups, providing comprehensive coverage for cognitive agent development.\n\n#### Extensible Resources & Infrastructure\n- **Web Search**: Multi-provider integration (Tavily, Google AI Search, Serper)\n- **Vector Stores**: Production-ready backends (Weaviate, PgVector) with semantic search\n- **Document Processing**: Intelligent text extraction and chunking for RAG workflows\n- **Voice Processing**: Advanced transcription and audio analysis capabilities\n\n#### Toolkit Ecosystem (17+ Tools)\n- **Academic Research**: arXiv integration for paper discovery and analysis\n- **Development Tools**: Bash execution, file editing, GitHub integration, Python execution\n- **Media Processing**: Image analysis, video processing, audio transcription\n- **Information Retrieval**: Wikipedia, web search, and knowledge extraction\n- **Data Management**: Tabular data processing, memory systems, document handling\n- **Human Interaction**: User communication and feedback collection systems\n\n#### Architecture & Performance\n- **Lazy Loading**: Only load what you need, when you need it\n- **Semantic Organization**: Intuitive grouping reduces cognitive overhead\n- **Async-First Design**: Built for high-performance concurrent operations\n- **Extensible Registry**: Easy integration of custom tools and capabilities\n- **Error Resilience**: Graceful handling of missing dependencies and failures\n\n## \u26a1 Lazy Loading & Performance\n\nCogents-tools features an advanced **lazy loading system** that dramatically improves import performance and reduces memory usage:\n\n- **\ud83d\ude80 Fast imports**: Only load what you need, when you need it\n- **\ud83d\udce6 Group-wise loading**: Import semantic groups of related toolkits\n- **\ud83d\udcbe Memory efficient**: Unused toolkits remain unloaded\n- **\ud83d\udd27 Zero configuration**: Lazy loading is enabled by default\n\n### Available Toolkit Groups\n\n| Group | Description | Toolkits |\n|-------|-------------|----------|\n| `academic` | Academic research tools | arxiv_toolkit |\n| `audio` | Audio processing | audio_toolkit, audio_aliyun_toolkit |\n| `communication` | Communication & messaging | memory_toolkit |\n| `development` | Development tools | bash_toolkit, file_edit_toolkit, github_toolkit, python_executor_toolkit, tabular_data_toolkit |\n| `file_processing` | File manipulation | document_toolkit, file_edit_toolkit, tabular_data_toolkit |\n| `hitl` | Human-in-the-loop | user_interaction_toolkit |\n| `image` | Image processing | image_toolkit |\n| `info_retrieval` | Information search | search_toolkit, serper_toolkit, wikipedia_toolkit |\n| `persistence` | Data storage | memory_toolkit |\n| `video` | Video processing | video_toolkit |\n\n## Install\n\n```bash\npip install -U cogents-tools\n```\n\n## \ud83d\ude80 Quick Examples\n\n### Lazy Loading\n\n```python\nimport cogents_tools\n\n# Check lazy loading status\nprint(f\"Lazy loading enabled: {cogents_tools.is_lazy_loading_enabled()}\")\n\n# Get available groups\nprint(f\"Available groups: {cogents_tools.get_available_groups()}\")\n\n# Load specific group\ndev_toolkits = cogents_tools.load_toolkit_group('development')\n\n# Monitor loaded modules\nprint(f\"Loaded modules: {cogents_tools.get_loaded_modules()}\")\n```\n\n### Agent-Tools Integration\n\nTODO\n\n## \ud83d\udcda Demo Scripts\n\nExplore the capabilities with our comprehensive demo scripts under [examples](./examples) folder.\n\n## Best Practices\n\n1. **Use group imports** for related functionality\n2. **Keep lazy loading enabled** unless you have specific requirements\n3. **Use the demos** to understand performance characteristics\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Acknowledgment\n\n- Tencent [Youtu-agent](https://github.com/Tencent/Youtu-agent) toolkits integration.\n",
"bugtrack_url": null,
"license": null,
"summary": "Supportive tools for Cogents, towards a cognitive agentic system",
"version": "0.1.5.3",
"project_urls": {
"Homepage": "https://github.com/mirasurf/cogents-tools",
"Repository": "https://github.com/mirasurf/cogents-tools"
},
"split_keywords": [
"agents",
" multi-agent system",
" cognition",
" artificial intelligence"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "e29dd48b795c7587d3a6431f5e0e75e949e5e600e610e3edf3be2bfb38d5ae6e",
"md5": "c669e3e4a25961d0605c6a41af47e2bc",
"sha256": "a9690dc956e4eb9890c8ab36e2465ac0760ba5963231e2a79b875c885303ea76"
},
"downloads": -1,
"filename": "cogents_tools-0.1.5.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c669e3e4a25961d0605c6a41af47e2bc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 458482,
"upload_time": "2025-09-11T07:22:20",
"upload_time_iso_8601": "2025-09-11T07:22:20.379282Z",
"url": "https://files.pythonhosted.org/packages/e2/9d/d48b795c7587d3a6431f5e0e75e949e5e600e610e3edf3be2bfb38d5ae6e/cogents_tools-0.1.5.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a11d7906ace0f247e2236be760201cdd5275b8321da92fb92f0cd99ebe18b0ba",
"md5": "38d0680bc589870d9a7e151afa9031d8",
"sha256": "ff7ef9de761a514f73d0579a97f9cb9d3cb799238d0a4027ec422c807414b0ba"
},
"downloads": -1,
"filename": "cogents_tools-0.1.5.3.tar.gz",
"has_sig": false,
"md5_digest": "38d0680bc589870d9a7e151afa9031d8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 385675,
"upload_time": "2025-09-11T07:22:22",
"upload_time_iso_8601": "2025-09-11T07:22:22.322286Z",
"url": "https://files.pythonhosted.org/packages/a1/1d/7906ace0f247e2236be760201cdd5275b8321da92fb92f0cd99ebe18b0ba/cogents_tools-0.1.5.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-11 07:22:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mirasurf",
"github_project": "cogents-tools",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cogents-tools"
}
JSON
