Metadata-Version: 2.4
Name: cogents-smith
Version: 0.1.8
Summary: Supportive tools for Cogents, towards a cognitive agentic system
Author-email: Xiaming Chen <chenxm35@gmail.com>
Maintainer-email: Xiaming Chen <chenxm35@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/caesar0301/cogents-smith
Project-URL: Repository, https://github.com/caesar0301/cogents-smith
Keywords: agents,multi-agent system,cognition,artificial intelligence
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: cogents-core<0.2.0,>=0.1.9
Requires-Dist: aiohttp>=3.12.15
Requires-Dist: aiofiles>=24.1.0
Requires-Dist: anyio>=4.9.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: psutil>=7.0.0
Requires-Dist: google-genai<2.0.0,>=1.29.0
Requires-Dist: tavily-python>=0.3.0
Requires-Dist: langchain-tavily>=0.2.11
Requires-Dist: arxiv>=2.2.0
Requires-Dist: matplotlib>=3.8.0
Requires-Dist: pexpect>=4.9.0
Requires-Dist: ipython>=8.18.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: pillow<12.0,>=10.1.0
Requires-Dist: pymupdf>=1.23.0
Requires-Dist: openpyxl>=3.1.5
Requires-Dist: aliyun-python-sdk-core<3.0.0,>=2.13.1
Requires-Dist: google-api-python-client>=2.174.0
Requires-Dist: google-auth-oauthlib>=1.2.2
Requires-Dist: google-auth>=2.40.3
Requires-Dist: wikipedia-api>=0.6.0
Provides-Extra: dev
Requires-Dist: pytest<9,>=8.2; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=1.1.0; extra == "dev"
Requires-Dist: pytest-tornasync>=0.6.0.post2; extra == "dev"
Requires-Dist: pytest-trio>=0.8.0; extra == "dev"
Requires-Dist: pytest-twisted>=1.14.3; extra == "dev"
Requires-Dist: twisted>=25.5.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: flake8>=7.3.0; extra == "dev"
Requires-Dist: autoflake>=2.3.1; extra == "dev"
Dynamic: license-file

# Cogents-Tools

[![CI](https://github.com/caesar0301/cogents-smith/actions/workflows/ci.yml/badge.svg)](https://github.com/caesar0301/cogents-smith/actions/workflows/ci.yml)
[![PyPI version](https://img.shields.io/pypi/v/cogents-smith.svg)](https://pypi.org/project/cogents-smith/)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/caesar0301/cogents-smith)

This is part of [project Cogents](https://github.com/caesar0301/cogents), an initiative to develop a cognitive, computation-driven agentic system. This repo is built upon [cogents-core](https://github.com/caesar0301/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 **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

## 📦 Semantic Organization

Cogents-tools features **semantic organization** that makes it easy to find and use related toolkits:

- **🎯 Organized structure**: Toolkits grouped by functionality
- **📦 Group-wise loading**: Import semantic groups of related toolkits
- **🔧 Easy discovery**: Simple group-based API

### 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-smith
```

## 🚀 Quick Examples

### Group Loading

```python
import cogents_smith

# Get available groups
print(f"Available groups: {cogents_smith.get_available_groups()}")

# Load specific group
dev_toolkits = cogents_smith.load_toolkit_group('development')
```

### 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. **Use semantic groups** to organize your toolkit imports
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.
