Metadata-Version: 2.4
Name: cyclops-ai
Version: 0.1.0
Summary: Core agent framework with MCP toolkit support
Project-URL: Homepage, https://github.com/gopalji/cyclops
Project-URL: Repository, https://github.com/gopalji/cyclops
Project-URL: Issues, https://github.com/gopalji/cyclops/issues
Author: Gopalji Gaur
License: MIT
License-File: LICENSE
Keywords: agents,ai,litellm,llm,mcp,tools
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: hatchling>=1.27.0
Requires-Dist: litellm>=1.79.1
Requires-Dist: mcp>=1.21.0
Requires-Dist: pluggy>=1.6.0
Requires-Dist: pydantic>=2.12.4
Description-Content-Type: text/markdown

# Cyclops

A barebones core agent framework with MCP toolkit support.

*AI → A I → A-eye → One eye → Cyclops*

## Features

- **Core Agent Framework**: Simple, extensible agent architecture with LiteLLM integration
- **Tool System**: Flexible tool registry with MCP support
- **Memory Management**: Abstract memory interface with implementations

## Quick Start

```python
from cyclops import Agent, AgentConfig
from cyclops.toolkit import tool

@tool
def get_time() -> str:
    """Get current time"""
    from datetime import datetime
    return datetime.now().strftime("%H:%M:%S")

config = AgentConfig(model="gpt-4o-mini")
agent = Agent(config, tools=[get_time])

response = agent.run("What time is it?")
print(response)
```

[//]: # (## Installation)

[//]: # ()
[//]: # (```bash)

[//]: # (# Install with uv &#40;recommended&#41;)

[//]: # (uv add cyclops)

[//]: # (```)

## Structure

```
cyclops/
├── core/           # Core agent framework
├── toolkit/        # Tools and utilities
├── mcp/           # MCP server/client
└── utils/         # Utilities and config
```

## Development

```bash
# Install dependencies
uv sync

# Setup pre-commit hooks
uv run pre-commit install

# Run checks manually
uv run pre-commit run --all-files
```