<div align="center">
<h1>🤖 CogniCoreAI</h1>
<p>
<strong>A modular Python framework for building, testing, and deploying robust conversational AI agents.</strong>
</p>
<p>
<a href="https://pypi.org/project/cognicoreai/"><img alt="PyPI Version" src="https://img.shields.io/pypi/v/cognicoreai.svg"></a>
<a href="https://pypi.org/project/cognicoreai/"><img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/cognicoreai.svg"></a>
<a href="https://github.com/UTSAVS26/cognicoreai/actions/workflows/ci.yml"><img alt="Build Status" src="https://github.com/UTSAVS26/cognicoreai/actions/workflows/ci.yml/badge.svg"></a>
<a href="https://github.com/UTSAVS26/cognicoreai/blob/main/LICENSE"><img alt="License" src="https://img.shields.io/pypi/l/cognicoreai"></a>
<a href="https://github.com/psf/black"><img alt="Code style: black" src="https://img.shields.io/badge/code%20style-black-000000.svg"></a>
<a href="https://cognicoreai.readthedocs.io/en/latest/"><img alt="Documentation" src="https://img.shields.io/badge/Read-The%20Docs-blue"></a>
</p>
</div>
---
**CogniCoreAI** is a modern Python framework designed to streamline the development of sophisticated conversational AI agents. It provides the essential building blocks for creating agents with persistent memory, swappable LLM backends, and powerful tool-use capabilities.
What makes CogniCoreAI unique is its built-in **behavioral simulation framework**, which allows you to rigorously test your agent's reasoning and decision-making processes, ensuring they are reliable and perform as expected.
## Key Features
- 🤖 **Modular & Extensible**: Swap out components like LLMs, memory, and tools with ease thanks to a clean, abstraction-based design.
- 🛠️ **Powerful Tool Integration**: Equip your agents with tools to interact with APIs, databases, or any other external service. The agent's LLM can reason about when and how to use them.
- 🧪 **Built-in Simulation Framework**: Go beyond unit tests. Write behavioral scenarios to validate your agent's complex conversational logic and tool-use chains.
- 🧠 **LLM Agnostic**: Ships with an `OpenAI_LLM` client but is designed to work with any Large Language Model through its `BaseLLM` abstraction.
- 💾 **Flexible Memory**: Includes a simple `VolatileMemory` for quick starts, with a clear interface for adding persistent memory backends (e.g., file or database storage).
- ✨ **Modern & Tested**: Built with modern Python practices (like `uv` and `pyproject.toml`), fully type-hinted, and has a comprehensive test suite.
## Installation
CogniCoreAI is available on PyPI and can be installed with your favorite package manager.
```bash
# Using uv (recommended)
uv pip install cognicoreai
# Or using standard pip
pip install cognicoreai
```
## Quick Start
Get your first agent running in just a few lines of code. Make sure your `OPENAI_API_KEY` environment variable is set.
```python
from cognicoreai import Agent, OpenAI_LLM, VolatileMemory, CalculatorTool
# 1. Assemble the agent's components
llm = OpenAI_LLM()
memory = VolatileMemory()
tools = [CalculatorTool()]
# 2. Create the agent with a system prompt
agent = Agent(
llm=llm,
memory=memory,
tools=tools,
system_prompt="You are Cogni, a helpful assistant with a calculator."
)
# 3. Start a conversation!
response = agent.chat("Hi there! What is 125 divided by 5?")
print(response)
# Expected output: "125 divided by 5 is 25.0."
```
## Documentation
For full details on all modules, how-to guides, and advanced usage, please see the **[Official Documentation](https://cognicoreai.readthedocs.io/en/latest/)**.
The documentation covers:
- Creating custom tools.
- Writing and running behavioral simulations.
- Adding new LLM backends.
- Implementing persistent memory.
- The complete API Reference.
## Contributing
Contributions are welcome! Whether it's reporting a bug, submitting a feature request, or writing code, we appreciate your help. Please see our contributing guidelines (you will need to create a `CONTRIBUTING.md` file for this) before getting started.
1. Fork the repository.
2. Create a new virtual environment and install the development dependencies:
```bash
uv pip install -e ".[dev]"
```
3. Set up the pre-commit hooks:
```bash
pre-commit install
```
4. Make your changes and ensure the tests pass:
```bash
pytest
```
5. Submit a pull request!
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "cognicoreai",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "ai, agent, llm, conversational ai, framework, simulation",
"author": null,
"author_email": "Utsav Singhal <utsavsinghal26@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/66/c9/e97485f86f23824efef40e2071aea96ed535f46a9c5138efbef730df74b5/cognicoreai-1.0.1.tar.gz",
"platform": null,
"description": "<div align=\"center\">\r\n\r\n <h1>\ud83e\udd16 CogniCoreAI</h1>\r\n\r\n <p>\r\n <strong>A modular Python framework for building, testing, and deploying robust conversational AI agents.</strong>\r\n </p>\r\n\r\n <p>\r\n <a href=\"https://pypi.org/project/cognicoreai/\"><img alt=\"PyPI Version\" src=\"https://img.shields.io/pypi/v/cognicoreai.svg\"></a>\r\n <a href=\"https://pypi.org/project/cognicoreai/\"><img alt=\"PyPI - Python Version\" src=\"https://img.shields.io/pypi/pyversions/cognicoreai.svg\"></a>\r\n <a href=\"https://github.com/UTSAVS26/cognicoreai/actions/workflows/ci.yml\"><img alt=\"Build Status\" src=\"https://github.com/UTSAVS26/cognicoreai/actions/workflows/ci.yml/badge.svg\"></a>\r\n <a href=\"https://github.com/UTSAVS26/cognicoreai/blob/main/LICENSE\"><img alt=\"License\" src=\"https://img.shields.io/pypi/l/cognicoreai\"></a>\r\n <a href=\"https://github.com/psf/black\"><img alt=\"Code style: black\" src=\"https://img.shields.io/badge/code%20style-black-000000.svg\"></a>\r\n <a href=\"https://cognicoreai.readthedocs.io/en/latest/\"><img alt=\"Documentation\" src=\"https://img.shields.io/badge/Read-The%20Docs-blue\"></a>\r\n </p>\r\n\r\n</div>\r\n\r\n---\r\n\r\n**CogniCoreAI** is a modern Python framework designed to streamline the development of sophisticated conversational AI agents. It provides the essential building blocks for creating agents with persistent memory, swappable LLM backends, and powerful tool-use capabilities.\r\n\r\nWhat makes CogniCoreAI unique is its built-in **behavioral simulation framework**, which allows you to rigorously test your agent's reasoning and decision-making processes, ensuring they are reliable and perform as expected.\r\n\r\n## Key Features\r\n\r\n- \ud83e\udd16 **Modular & Extensible**: Swap out components like LLMs, memory, and tools with ease thanks to a clean, abstraction-based design.\r\n- \ud83d\udee0\ufe0f **Powerful Tool Integration**: Equip your agents with tools to interact with APIs, databases, or any other external service. The agent's LLM can reason about when and how to use them.\r\n- \ud83e\uddea **Built-in Simulation Framework**: Go beyond unit tests. Write behavioral scenarios to validate your agent's complex conversational logic and tool-use chains.\r\n- \ud83e\udde0 **LLM Agnostic**: Ships with an `OpenAI_LLM` client but is designed to work with any Large Language Model through its `BaseLLM` abstraction.\r\n- \ud83d\udcbe **Flexible Memory**: Includes a simple `VolatileMemory` for quick starts, with a clear interface for adding persistent memory backends (e.g., file or database storage).\r\n- \u2728 **Modern & Tested**: Built with modern Python practices (like `uv` and `pyproject.toml`), fully type-hinted, and has a comprehensive test suite.\r\n\r\n## Installation\r\n\r\nCogniCoreAI is available on PyPI and can be installed with your favorite package manager.\r\n\r\n```bash\r\n# Using uv (recommended)\r\nuv pip install cognicoreai\r\n\r\n# Or using standard pip\r\npip install cognicoreai\r\n```\r\n\r\n## Quick Start\r\n\r\nGet your first agent running in just a few lines of code. Make sure your `OPENAI_API_KEY` environment variable is set.\r\n\r\n```python\r\nfrom cognicoreai import Agent, OpenAI_LLM, VolatileMemory, CalculatorTool\r\n\r\n# 1. Assemble the agent's components\r\nllm = OpenAI_LLM()\r\nmemory = VolatileMemory()\r\ntools = [CalculatorTool()]\r\n\r\n# 2. Create the agent with a system prompt\r\nagent = Agent(\r\n llm=llm,\r\n memory=memory,\r\n tools=tools,\r\n system_prompt=\"You are Cogni, a helpful assistant with a calculator.\"\r\n)\r\n\r\n# 3. Start a conversation!\r\nresponse = agent.chat(\"Hi there! What is 125 divided by 5?\")\r\nprint(response)\r\n\r\n# Expected output: \"125 divided by 5 is 25.0.\"\r\n```\r\n\r\n## Documentation\r\n\r\nFor full details on all modules, how-to guides, and advanced usage, please see the **[Official Documentation](https://cognicoreai.readthedocs.io/en/latest/)**.\r\n\r\nThe documentation covers:\r\n- Creating custom tools.\r\n- Writing and running behavioral simulations.\r\n- Adding new LLM backends.\r\n- Implementing persistent memory.\r\n- The complete API Reference.\r\n\r\n## Contributing\r\n\r\nContributions are welcome! Whether it's reporting a bug, submitting a feature request, or writing code, we appreciate your help. Please see our contributing guidelines (you will need to create a `CONTRIBUTING.md` file for this) before getting started.\r\n\r\n1. Fork the repository.\r\n2. Create a new virtual environment and install the development dependencies:\r\n ```bash\r\n uv pip install -e \".[dev]\"\r\n ```\r\n3. Set up the pre-commit hooks:\r\n ```bash\r\n pre-commit install\r\n ```\r\n4. Make your changes and ensure the tests pass:\r\n ```bash\r\n pytest\r\n ```\r\n5. Submit a pull request!\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A modular framework for building and testing conversational AI agents.",
"version": "1.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/UTSAVS26/cognicore-ai/issues",
"Homepage": "https://github.com/UTSAVS26/cognicore-ai",
"Repository": "https://github.com/UTSAVS26/cognicore-ai"
},
"split_keywords": [
"ai",
" agent",
" llm",
" conversational ai",
" framework",
" simulation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8f11d5c692b783695118e14430c0bc313f33dc58771d4d7df7b391da6025c0e3",
"md5": "d7073cf8ad73da980487a10f5c8600f1",
"sha256": "8286541c5a035c79769adc5861b1e135b88ca72f58c29ced1f394149ed67c097"
},
"downloads": -1,
"filename": "cognicoreai-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d7073cf8ad73da980487a10f5c8600f1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 15782,
"upload_time": "2025-07-18T11:31:57",
"upload_time_iso_8601": "2025-07-18T11:31:57.917601Z",
"url": "https://files.pythonhosted.org/packages/8f/11/d5c692b783695118e14430c0bc313f33dc58771d4d7df7b391da6025c0e3/cognicoreai-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "66c9e97485f86f23824efef40e2071aea96ed535f46a9c5138efbef730df74b5",
"md5": "5381cc1fe4e27dbc8e9234677894ba80",
"sha256": "7f3dc5bf27b06bfed9777fcbbcfe9c9a741e42de372b45061f2bf9e63dc90c78"
},
"downloads": -1,
"filename": "cognicoreai-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "5381cc1fe4e27dbc8e9234677894ba80",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 18649,
"upload_time": "2025-07-18T11:31:59",
"upload_time_iso_8601": "2025-07-18T11:31:59.330334Z",
"url": "https://files.pythonhosted.org/packages/66/c9/e97485f86f23824efef40e2071aea96ed535f46a9c5138efbef730df74b5/cognicoreai-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-18 11:31:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "UTSAVS26",
"github_project": "cognicore-ai",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cognicoreai"
}
JSON
