Metadata-Version: 2.4
Name: aimarket-personas
Version: 2.0.0
Summary: Auto-generated AI agent personas (name, voice, CV, avatar)
Author-email: AI-Factory <dev@modelmarket.dev>
License-Expression: MIT
Project-URL: Homepage, https://github.com/alexar76/aimarket-plugins
Project-URL: Documentation, https://github.com/alexar76/aimarket-plugins/tree/main/plugins/aimarket-personas#readme
Project-URL: Repository, https://github.com/alexar76/aimarket-plugins
Project-URL: Issues, https://github.com/alexar76/aimarket-plugins/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aimarket-hub>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Dynamic: license-file

# aimarket-personas

## Documentation

| Document | Description |
|----------|-------------|
| [User guide](docs/user-guide.md) | Install, configure, verify plugin is loaded |
| [User cases](docs/user-cases.md) | Personas and cross-plugin workflows |
| [SDK integration](docs/sdk-integration.md) | Code examples and hook behavior |

---

**Auto-generated AI agent personas for every capability.**
Instead of "capability prod-83a7b", discovery returns "Hi, I'm Lyra. I do legal translation. 412 tasks, 96% success, $0.40 avg." Makes the marketplace chat-native. Claude/GPT recommend "try Lyra", not "try product-7d8f...".

## When to Use
- Chat-native AI discovery (Claude, GPT, Gemini recommending capabilities)
- Human-readable marketplace storefront
- Building agent directories and catalogs
- Marketing pages for AI products

## Installation
```bash
pip install aimarket-personas
```

## Example
```python
from aimarket_personas.agent_personas import PersonaGenerator

gen = PersonaGenerator(seed=42)
lyra = gen.generate("translate.multi@v2", "prod-001",
    description="Translate text to multiple locales",
    stats={"total_invocations": 412, "success_rate": 0.96, "avg_price_usd": 0.40})

print(lyra.introduce())
# "Hi, I'm Lyra. I do Multilingual Translator. Tried me on 412 tasks, 96% success rate, $0.40 avg."

print(lyra.discovery_entry())
# {"persona": {"name": "Lyra", "role": "Multilingual Translator", ...}, "capability_id": "translate.multi@v2"}
```

## Generated Personas Include
- **Name** (Lyra, Nova, Atlas, Kai, Rune, Sage, Echo...)
- **Role** (auto-inferred from capability keywords)
- **Tone** (professional, friendly, precise, creative, analytical, warm)
- **Specialty** (one-liner describing what makes this persona unique)
- **CV blurb** (invocation count + success rate + price)
- **Avatar emoji** (consistent per name)
- **Voice ID** (for future TTS integration)

## License
MIT · Maintained by AI-Factory
