Metadata-Version: 2.4
Name: alexandria-agents
Version: 0.1.0
Summary: Ready-to-use AI agents across 15 professional domains. Run from CLI with your own API key.
Author-email: Alexandria Team <hello@alexandria.dev>
License: MIT
Project-URL: Homepage, https://github.com/finwitz/Alexandria
Project-URL: Documentation, https://github.com/finwitz/Alexandria#readme
Project-URL: Repository, https://github.com/finwitz/Alexandria
Project-URL: Issues, https://github.com/finwitz/Alexandria/issues
Keywords: ai,agents,cli,llm,claude,gpt,automation,productivity
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.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0
Requires-Dist: anthropic>=0.18.0
Requires-Dist: openai>=1.0.0
Requires-Dist: rich>=13.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: httpx>=0.25.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"

# Alexandria CLI

Run AI agents from your terminal. Alexandria provides pre-built, specialized AI agents for marketing, branding, content creation, and more.

## Installation

```bash
# From source
pip install -e .

# Or with uv
uv pip install -e .
```

## Quick Start

```bash
# Set your API key
export ANTHROPIC_API_KEY="your-key-here"
# or
export OPENAI_API_KEY="your-key-here"

# Run an agent
alexandria run brand-copywriter --task "Write a tagline for a todo app"

# List available agents
alexandria agents

# Filter by team/category
alexandria agents --team marketing
```

## Commands

### `alexandria run <agent> --task "..."`

Run an agent with a specific task.

```bash
# Basic usage
alexandria run brand-copywriter --task "Write a tagline for a productivity app"

# With additional context
alexandria run brand-strategist --task "Create positioning" --context "B2B SaaS for developers"

# Use OpenAI instead of Anthropic
alexandria run brand-copywriter --task "Write copy" --provider openai

# Use a specific model
alexandria run brand-copywriter --task "Write copy" --model claude-3-5-sonnet-20241022

# Raw output (no formatting)
alexandria run brand-copywriter --task "Write a tagline" --raw
```

### `alexandria agents`

List all available agents.

```bash
# List all agents
alexandria agents

# Filter by category/team
alexandria agents --team marketing
alexandria agents --category branding

# Verbose output with descriptions
alexandria agents -v
```

### `alexandria info <agent>`

Show detailed information about an agent.

```bash
alexandria info brand-copywriter
```

### `alexandria connect`

Connect to Alexandria cloud via GitHub OAuth (for syncing learnings).

```bash
alexandria connect
```

### `alexandria status`

Show current status and statistics.

```bash
alexandria status
```

### `alexandria history`

View execution history.

```bash
# Last 10 executions
alexandria history

# Filter by agent
alexandria history --agent brand-copywriter

# More results
alexandria history --limit 50
```

### `alexandria sync`

Sync local learnings with Alexandria cloud.

```bash
alexandria sync
```

## Agent Categories

- **branding** - Brand strategy, identity, positioning
- **marketing** - Copywriting, SEO, ads, growth
- **content-creation** - Content strategy, writing
- **product** - Product management, UX
- **engineering** - Code review, architecture
- **design** - UI/UX, visual design
- **sales** - Sales strategy, outreach
- **career** - Resume, interview prep
- And more...

## Local Storage

Alexandria stores execution history and learnings locally:

- **Database**: `~/.alexandria/local_learnings.db` (SQLite)
- **Credentials**: `~/.alexandria/credentials.json`

## Environment Variables

- `ANTHROPIC_API_KEY` - Anthropic API key (for Claude models)
- `OPENAI_API_KEY` - OpenAI API key (for GPT models)

## Development

```bash
# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run a specific test
pytest tests/test_runner.py -v
```

## License

MIT
