Metadata-Version: 2.4
Name: aceai
Version: 0.1.3
Summary: AI agent framework that delivers
Author-email: raceychan <raceychan@gmail.com>
Requires-Python: >=3.12
Requires-Dist: dotenv>=0.9.9
Requires-Dist: ididi==1.8.0
Requires-Dist: jupyter>=1.1.1
Requires-Dist: msgspec>=0.20.0
Requires-Dist: openai>=2.9.0
Requires-Dist: typing-extensions>=4.15.0
Description-Content-Type: text/markdown

# AceAI

> ⚠️ **Experimental Project** - AceAI is currently in early development. APIs may change frequently. 
> 
> ⭐ **Star this repo** to stay updated on our progress and be notified of major releases!

**Ace AI - Agent framework that delivers**

AceAI is a powerful and intuitive agent framework designed to help you build intelligent agents that deliver results. Whether you're creating conversational bots, task automation agents, or complex AI workflows, AceAI provides the tools you need to succeed.

## Installation

```bash
pip install aceai
```

## Usage

### Quick Start

```python
from aceai import Agent, Task

# Create a simple agent
agent = Agent(name="TaskBot")

# Define a task
task = Task(
    description="Analyze user input and provide helpful response",
    handler=lambda input_text: f"Processing: {input_text}"
)

# Execute the task
result = agent.execute(task, "Hello, how can you help me?")
print(result)  # Processing: Hello, how can you help me?
```

### Advanced Agent Example

```python
from aceai import Agent, Pipeline

# Create an intelligent agent with multiple capabilities
agent = Agent(
    name="SmartAssistant",
    capabilities=["text_analysis", "task_planning", "response_generation"]
)

# Create a processing pipeline
pipeline = Pipeline([
    "understand_intent",
    "plan_response", 
    "execute_action",
    "format_output"
])

# Process complex requests
response = agent.process("Plan a meeting for next week with the development team")
print(response)
```

## Key Features

- 🚀 **Fast Setup**: Get your agents running in minutes
- 🧠 **Intelligent**: Built-in reasoning and decision-making capabilities  
- 🔧 **Flexible**: Easily customizable for any use case
- 📈 **Scalable**: Handle everything from simple bots to complex workflows
- 🛡️ **Reliable**: Production-ready with robust error handling

## Why AceAI?

Because when you need AI agents that actually deliver, you need AceAI. Our framework combines simplicity with power, letting you focus on building great agent experiences rather than wrestling with complex infrastructure.

**Ace AI - Agent framework that delivers** ✨