| Name | cogent-base JSON |
| Version |
0.1.17
JSON |
| download |
| home_page | None |
| Summary | Base and shared modules for cogents |
| upload_time | 2025-07-23 02:41:55 |
| maintainer | None |
| docs_url | None |
| author | xmingc |
| requires_python | <3.12,>=3.10 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Cogent Base
[](https://pypi.python.org/pypi/cogent-base)
[](https://opensource.org/licenses/MIT)
[](https://github.com/mirasurf/cogent-base/actions/workflows/ci.yml)
A shared Python module for agentic cognitive computing frameworks, providing extensible configuration management, logging utilities, and core components.
## Features
- **Extensible Configuration System**: Register custom configurations with TOML support
- **Flexible Logging**: Basic logging utilities that can be overridden by downstream libraries
- **Provider Abstraction**: Unified interfaces for LLM, embedding, reranking, and vector store providers
- **Sensory Processing**: Document parsing and text chunking capabilities
- **Modular Design**: Clean separation of concerns with extensible architecture
## Installation
**Requirements**: Python 3.11+
```bash
pip install cogent-base
```
To use advanced vendor's features, install with
```bash
pip install cogent-base[extensions]
```
to enable features:
- vector stores of weaviate
- FlagEmbedding
- video parser with assemblyai
- smart frame with pandasai
- smart voice with ailyun lingjie NLS
For development:
```bash
git clone https://github.com/mirasurf/cogent-base.git
cd cogent-base
make install-dev
```
## Quick Start
```python
from cogent_base.config import get_cogent_config
# Get the global configuration
config = get_cogent_config()
# Access built-in configurations
llm_config = config.llm
vector_store_config = config.vector_store
```
## Documentation
- **[Examples](examples/)** - Practical usage examples for all features
- **[Development Guide](DEVELOPMENT.md)** - Setup, testing, and deployment procedures
- **[Testing Guide](tests/README.md)** - Comprehensive testing documentation
## Core Components
### Configuration System
- Layered configuration loading (Class Defaults → Package TOML → User TOML)
- Custom configuration class registration
- TOML-based configuration files
### Provider Interfaces
- **LLM Providers**: LiteLLM-based completion models
- **Embedding Providers**: Text embedding generation
- **Vector Stores**: Weaviate integration for vector operations
- **Reranking**: Document reranking capabilities
### Sensory Processing
- **Document Parsing**: Multi-format document text extraction
- **Text Chunking**: Configurable text splitting with overlap
### Smart Processing
- **Smart DataFrame**: dataframe talks to LLM with pandasai
- **Smart Voice**: voice-to-text transcription based on Aliyun Lingji AI.
## License
MIT
Raw data
{
"_id": null,
"home_page": null,
"name": "cogent-base",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.12,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "xmingc",
"author_email": "chenxm35@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/29/f6/3f516572fe09e63941e43e4023791d20bdbb5bd2afe941712fa38d0cf86e/cogent_base-0.1.17.tar.gz",
"platform": null,
"description": "# Cogent Base\n\n[](https://pypi.python.org/pypi/cogent-base)\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/mirasurf/cogent-base/actions/workflows/ci.yml)\n\nA shared Python module for agentic cognitive computing frameworks, providing extensible configuration management, logging utilities, and core components.\n\n## Features\n\n- **Extensible Configuration System**: Register custom configurations with TOML support\n- **Flexible Logging**: Basic logging utilities that can be overridden by downstream libraries\n- **Provider Abstraction**: Unified interfaces for LLM, embedding, reranking, and vector store providers\n- **Sensory Processing**: Document parsing and text chunking capabilities\n- **Modular Design**: Clean separation of concerns with extensible architecture\n\n## Installation\n\n**Requirements**: Python 3.11+\n\n```bash\npip install cogent-base\n```\n\nTo use advanced vendor's features, install with\n\n```bash\npip install cogent-base[extensions]\n```\n\nto enable features:\n\n- vector stores of weaviate\n- FlagEmbedding\n- video parser with assemblyai\n- smart frame with pandasai\n- smart voice with ailyun lingjie NLS\n\nFor development:\n\n```bash\ngit clone https://github.com/mirasurf/cogent-base.git\ncd cogent-base\nmake install-dev\n```\n\n## Quick Start\n\n```python\nfrom cogent_base.config import get_cogent_config\n\n# Get the global configuration\nconfig = get_cogent_config()\n\n# Access built-in configurations\nllm_config = config.llm\nvector_store_config = config.vector_store\n```\n\n## Documentation\n\n- **[Examples](examples/)** - Practical usage examples for all features\n- **[Development Guide](DEVELOPMENT.md)** - Setup, testing, and deployment procedures\n- **[Testing Guide](tests/README.md)** - Comprehensive testing documentation\n\n## Core Components\n\n### Configuration System\n- Layered configuration loading (Class Defaults \u2192 Package TOML \u2192 User TOML)\n- Custom configuration class registration\n- TOML-based configuration files\n\n### Provider Interfaces\n- **LLM Providers**: LiteLLM-based completion models\n- **Embedding Providers**: Text embedding generation\n- **Vector Stores**: Weaviate integration for vector operations\n- **Reranking**: Document reranking capabilities\n\n### Sensory Processing\n- **Document Parsing**: Multi-format document text extraction\n- **Text Chunking**: Configurable text splitting with overlap\n\n### Smart Processing\n- **Smart DataFrame**: dataframe talks to LLM with pandasai\n- **Smart Voice**: voice-to-text transcription based on Aliyun Lingji AI.\n\n## License\n\nMIT\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Base and shared modules for cogents",
"version": "0.1.17",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "afa5ca3603f88a76928e3c69028f35d114b69e3ee6d6291a491581b3caeb9488",
"md5": "a19786ac05f380cbc175f74db90e28c6",
"sha256": "e04fdf5dc566822749a4052993cbf9d7c6f0d5e9b16e9dc79a1a319f0d73176a"
},
"downloads": -1,
"filename": "cogent_base-0.1.17-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a19786ac05f380cbc175f74db90e28c6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.10",
"size": 64849,
"upload_time": "2025-07-23T02:41:53",
"upload_time_iso_8601": "2025-07-23T02:41:53.977666Z",
"url": "https://files.pythonhosted.org/packages/af/a5/ca3603f88a76928e3c69028f35d114b69e3ee6d6291a491581b3caeb9488/cogent_base-0.1.17-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "29f63f516572fe09e63941e43e4023791d20bdbb5bd2afe941712fa38d0cf86e",
"md5": "36a4c5a168f0428cda9271069da98511",
"sha256": "a0f13c91d50ec84bc50bd8a2b5f885e7d9fb996adbd156fc4b601ed3fac10c24"
},
"downloads": -1,
"filename": "cogent_base-0.1.17.tar.gz",
"has_sig": false,
"md5_digest": "36a4c5a168f0428cda9271069da98511",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.10",
"size": 39086,
"upload_time": "2025-07-23T02:41:55",
"upload_time_iso_8601": "2025-07-23T02:41:55.051301Z",
"url": "https://files.pythonhosted.org/packages/29/f6/3f516572fe09e63941e43e4023791d20bdbb5bd2afe941712fa38d0cf86e/cogent_base-0.1.17.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-23 02:41:55",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "cogent-base"
}
