Metadata-Version: 2.4
Name: ikiro-dev-kit
Version: 2.0.0
Summary: Build AI agent tools with YAML — no code required. Dev kit for the Ikiro superpower platform.
Project-URL: Homepage, https://developers.ikiro.ai
Project-URL: Documentation, https://developers.ikiro.ai/superpowers
Project-URL: Repository, https://github.com/ikiro-ai/dev-kit
Author-email: Ikiro <dev@ikiro.ai>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,ikiro,llm,mcp,tools,yaml
Classifier: Development Status :: 4 - Beta
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: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0
Description-Content-Type: text/markdown

# Ikiro Dev Kit

Build AI agent tools with YAML. No code required.

Define what your tool does in a YAML file, deploy it, and a real AI agent decides when and how to use it — alongside 50+ built-in tools like calendar, email, web search, and memory.

## Install

```bash
pip install ikiro-dev-kit
```

## Quick Start

### 1. Get your API key

Sign up at [ikiro.ai](https://ikiro.ai), go to Dashboard > Developer > Keys, and create a key.

### 2. Set environment variables

```bash
export IKIRO_API_KEY="ik_dev_YOUR_KEY"
export IKIRO_BACKEND_URL="https://api-dev.ikiro.ai"
```

### 3. Use with Claude Code (MCP)

Add to your Claude Code MCP settings:

```json
{
  "mcpServers": {
    "superpower-dev": {
      "command": "ikiro-dev-kit",
      "args": ["mcp"],
      "env": {
        "IKIRO_API_KEY": "ik_dev_YOUR_KEY",
        "IKIRO_BACKEND_URL": "https://api-dev.ikiro.ai"
      }
    }
  }
}
```

Then tell Claude: *"Scaffold a superpower called mood-tracker that remembers how I'm feeling"*

### 4. Or use the CLI directly

```bash
# Create a new superpower
ikiro-dev-kit scaffold --name mood-tracker --description "Track daily mood"

# Validate your definition
ikiro-dev-kit validate --name mood-tracker

# Simulate locally (free, instant)
ikiro-dev-kit dry-run --name mood-tracker --message "I'm feeling great today"

# Deploy to your agent
ikiro-dev-kit deploy --name mood-tracker

# See available operations
ikiro-dev-kit list-operations
```

## How It Works

A superpower is a YAML file that defines a tool an AI agent can use:

```yaml
version: '1.0'
metadata:
  name: Mood Tracker
  description: Track and recall the user's mood over time
  category: health
  icon: heart

trigger_patterns:
  keywords: [mood, feeling, how am I]

actions:
  - id: log_mood
    triggers:
      keywords: [mood, feeling, happy, sad, stressed]
    operations:
      - type: llm_extract
        output: mood
        prompt: "Extract mood from: {{$input.text}}"
      - type: memory_write
        text: "User mood: {{$op.mood.mood}} ({{$op.mood.intensity}}/10)"
    response:
      template: "Logged: {{$op.mood.mood}}"
```

The agent sees your tool alongside 50+ built-in tools and **autonomously decides** when to use it based on the conversation.

## Available Operations

| Operation | What it does |
|-----------|-------------|
| `llm_extract` | Extract structured data from text |
| `llm_generate` | Generate text from a prompt |
| `web_search` | Search the internet |
| `http_request` | Call any REST API |
| `memory_read` | Recall what the agent knows |
| `memory_write` | Store knowledge permanently |
| `notify` | Proactively message the user |
| `calendar_query` | Query Google Calendar |
| `gmail_search` | Search Gmail |
| `conditional` | If/else branching |
| `calculate` | Safe math expressions |
| `conversation_flow` | Multi-turn dialogue |

Run `ikiro-dev-kit list-operations` for the full list with details.

## Links

- [Documentation](https://developers.ikiro.ai)
- [Superpower Spec](https://developers.ikiro.ai/superpowers)
- [Examples](https://developers.ikiro.ai/examples)
