Metadata-Version: 2.1
Name: cognitrix
Version: 0.2.2
Summary: Package for creating AI Agents using llms
Home-page: https://github.com/theonlyamos/cognitrix
License: Apache2
Keywords: cognitrix,ai,agents,ai agents,ai-agents,llms,autonomous agents
Author: theonlyamos
Author-email: theonlyamos@gmail.com
Requires-Python: >=3.12,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: aiofiles (>=23.2.1,<24.0.0)
Requires-Dist: aiohttp (>=3.9.3,<4.0.0)
Requires-Dist: anthropic (>=0.17.0,<0.18.0)
Requires-Dist: beautifulsoup4 (>=4.12.3,<5.0.0)
Requires-Dist: clarifai (>=10.1.0,<11.0.0)
Requires-Dist: cohere (>=4.50,<5.0)
Requires-Dist: deepgram-sdk (==3.*)
Requires-Dist: google-generativeai (>=0.4.0,<0.5.0)
Requires-Dist: google-search-results (>=2.4.2,<3.0.0)
Requires-Dist: groq (>=0.4.1,<0.5.0)
Requires-Dist: openai (>=1.12.0,<2.0.0)
Requires-Dist: pillow (>=10.2.0,<11.0.0)
Requires-Dist: pyautogui (>=0.9.54,<0.10.0)
Requires-Dist: pydantic (>=2.6.2,<3.0.0)
Requires-Dist: python-dotenv (>=1.0.1,<2.0.0)
Requires-Dist: pyttsx3 (>=2.90,<3.0)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Requires-Dist: serpapi (>=0.1.5,<0.2.0)
Requires-Dist: together (>=0.2.11,<0.3.0)
Requires-Dist: uuid (>=1.30,<2.0)
Requires-Dist: xmltodict (>=0.13.0,<0.14.0)
Project-URL: Bug Tracker, https://github.com/theonlyamos/cognitrix/issues
Project-URL: Repository, https://github.com/theonlyamos/cognitrix
Description-Content-Type: text/markdown

### Cognitrix
Cognitrix is an open-source autonous AI agents orchestrator built in Python. It allows you to create and manage AI agents easily.

### Features
- **`Agent Creation and Management`:** Create, list, and load AI agents with customizable names, tasks, and configurations.
- **`LLM Integration`:** Seamlessly integrate with multiple LLM providers, including Anthropic (Claude), Cohere, Groq, Google, OpenAI, and Together.
- **`Modular Architecture`:** Easily extend the framework by adding new tools, agents, and LLM integrations.
- **`Conversational Interface`:** Interact with AI agents through a command-line interface, providing queries and receiving responses.
- **`Tool Integration`:** Agents can utilize a variety of tools, such as calculators, web searches, file system browsers, and more.
- **`Autonomous Agent Mode`:** Enable agents to operate autonomously, visually perceiving the screen, interacting with UI elements, and performing tasks.
- **`Multimodal Support`:** Agents can handle both text and image inputs/outputs, enabling multimodal interactions.

### Architecture
Cognitrix's architecture is designed to be modular and extensible, with core components including:

1. **`Agents`:** The base Agent class and specialized classes like AIAssistant for creating and managing AI agents.
2. **`LLMs`:** A collection of classes for integrating with various LLM providers, such as Cohere, OpenAI, Claude, and more.
3. **`Tools`:** A set of tools that agents can utilize, including calculators, web searches, file system browsers, and more.
4. **`Templates`:** Customizable prompt templates for guiding the behavior and output formats of LLMs.

The architecture is highly modular and extensible. New tools and capabilities can be easily added.

### Getting Started

### Installation
```bash
pip install cognitrix
```
or
```bash
pip install https://github.com/theonlyamos/cognitrix/archive/main.zip
```

### Usage
Run with default settings
```bash
cognitrix
```

List supported providers
```bash
cognitrix --providers
```

Run with specific provider
```bash
cognitrix --provider <provider_name>
```

Create a new agent
```bash
cognitrix agents --new
```

List created agents
```bash
cognitrix agents
```

Run with specific agent
```bash
cognitrix --agent <agent_name>
```

Print help message
```bash
cognitrix --help
```

### Contributing
Cognitrix is open source and contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for more details.

### License
This project is licensed under the MIT license. See [LICENSE.md](LICENSE.md) for more details.

### Acknowledgments
Cognitrix was created by [Amos Amissah](https://github.com/theonlyamos) and is heavily inspired by projects like AutoGPT and GPT Engineer. Special thanks to the open-source community for their contributions and the AI companies providing LLM APIs.
