Metadata-Version: 2.4
Name: ai-character-sdk
Version: 0.1.1
Summary: A unified SDK for creating AI characters with memory, personality, and decision-making capabilities
Author-email: Casey <casey@example.com>
License: MIT
Project-URL: Homepage, https://github.com/casey/ai-character-sdk
Project-URL: Documentation, https://github.com/casey/ai-character-sdk#readme
Project-URL: Repository, https://github.com/casey/ai-character-sdk
Keywords: ai,character,agent,memory,llm,roleplay
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
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.0.0
Requires-Dist: numpy>=1.24.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Provides-Extra: llm
Requires-Dist: openai>=1.0.0; extra == "llm"
Requires-Dist: anthropic>=0.18.0; extra == "llm"
Dynamic: license-file

# ai-character-sdk

A unified Python SDK for creating AI characters with memory, personality, and decision-making capabilities. Combines an escalation engine, hierarchical memory, and outcome learning into a simple API.

## Brand Line

> Characters that remember, learn, and decide — built for fleet members.

## Installation

```bash
pip install cocapn-ai-character-sdk
```

## Quick Start

```python
from ai_character_sdk import Character

# Create a character
hero = Character(
    name="Finn the Brave",
    character_class="paladin",
    personality={"bravery": 0.9, "kindness": 0.8}
)

# Use the character
response = hero.think("I see a goblin approaching")
print(response.content)

# Remember experiences
hero.remember("The goblin was actually friendly", importance=7.0)

# Learn from outcomes
hero.learn(outcome="Made a new ally", success=True, reward=10.0)
```

## Features

- **Unified Character API** — Simple, intuitive interface for character creation
- **6-Tier Memory System** — Hierarchical memory inspired by cognitive neuroscience
- **Intelligent Decision Routing** — Cost-effective escalation engine (BOT/BRAIN/HUMAN tiers)
- **Dynamic Personality** — Trait-based behavior system
- **Outcome Learning** — Reinforcement learning from experience
- **Persistence** — Save and load character state
- **Character Presets** — Pre-built archetypes to get started quickly

## Fleet Context

Part of the Cocapn fleet. Related repos:
- [bordercollie](https://github.com/SuperInstance/bordercollie) — Fleet task herding and orchestration
- [agentic-compiler](https://github.com/SuperInstance/agentic-compiler) — Markdown-to-runtime compilation
- [cudaclaw](https://github.com/SuperInstance/cudaclaw) — GPU-accelerated agent orchestration

---
🦐 Cocapn fleet — lighthouse keeper architecture
