Metadata-Version: 2.4
Name: promptary-cli
Version: 1.3.1
Summary: CLI to retrieve prompt blueprints from the Promptary API
Requires-Python: >=3.10
Description-Content-Type: text/markdown

<p align="center">
  <img src="./src/promptary-banner.png" alt="Promptary Banner">
</p>

--- 

# Promptary

## AI Prompt Knowledge Library for Data Science & Machine Learning

Promptary is a collaborative platform and premium prompt blueprint library built specifically for Data Scientists, Machine Learning Engineers, and AI practitioners.

It works as a prompt engineering workspace where professionals can discover, optimize, organize, reuse, and share high-quality AI workflows for real-world data projects.

From exploratory analysis to model development and debugging, Promptary helps teams transform scattered AI interactions into reusable engineering assets.

---

# 🧠 Promptary Skills System

Promptary includes an intelligent **Skills System** for AI agents. The Orchestrator skill analyzes your question, delegates to the right specialist skill, and surfaces relevant blueprints.

```bash
# List available skills
promptary skill list

# Show skill details
promptary skill info "Machine Learning"

# Install a skill (activate in your agent environment)
promptary skill install orchestrator

# Analyze a question — Orchestrator detects intent & finds blueprints
promptary analyze "mi modelo de ML tiene overfitting"
promptary analyze "mi consulta SQL es muy lenta" --json

# Generate skill.json manifest for AI agent integration
promptary skill manifest orchestrator
```

Available skills:

| Skill | Role |
|---|---|
| Exploratory Data Analysis | Expert in EDA, patterns, correlations & profiling |
| Data Cleaning | Expert in missing values, outliers & normalization |
| Machine Learning | Expert in model selection, training & optimization |
| Data Visualization | Expert in charts, dashboards & storytelling |
| SQL & Databases | Expert in queries, optimization & schema design |
| Python Utilities | Expert in scripting, debugging & automation |

Each skill queries the Promptary catalog and returns relevant blueprints for your task.

---

# 🛠️ Installation & Usage

Promptary provides multiple ways to access and integrate prompt blueprints into your AI workflows.

---

## 📦 Install Promptary CLI

Install the official Python CLI tool:

```bash
pip install promptary-cli
```

Or install directly from the repository:

```bash
git clone https://github.com/promptary/promptary.git
cd promptary
pip install .
```

Verify the installation:

```bash
promptary --version
```

The CLI uses `https://promptary-cli-cr.xyz` as the default API endpoint.
Override it at runtime with the `PROMPTARY_API_URL` environment variable:

```bash
PROMPTARY_API_URL=https://custom-domain.com promptary pull p_1
```

---

# 🚀 Retrieve a Prompt Blueprint

Each Promptary blueprint has a unique identifier.

Example:

```
p_1
```

You can retrieve any blueprint dynamically using the Promptary CLI or API.

---

# 💻 Using Promptary CLI

Pull a blueprint directly from Promptary:

```bash
promptary pull p_1
```

This retrieves the latest version of the prompt template.

---

# 🐍 Using Python

Blueprints can be loaded directly into Python workflows:

```python
import requests

prompt_id = "p_1"

url = f"https://promptary-cli-cr.xyz/api/prompts/{prompt_id}/raw"

response = requests.get(url)
response.raise_for_status()

prompt_template = response.text

print("Loaded blueprint prompt successfully!")
print(prompt_template[:120] + "...")
```

Example output:

```
Loaded blueprint prompt successfully!

You are an expert Data Scientist specialized in...
```

Useful for:

- Jupyter Notebooks
- AI agents
- automation scripts
- ML workflows

---

# 🌐 Using cURL

Retrieve the raw prompt directly from the API:

```bash
curl -s "https://promptary-cli-cr.xyz/api/prompts/p_1/raw"
```

The API returns the blueprint as plain text.

---

# 🔌 Integration Workflow

Promptary blueprints can be integrated into:

- Python applications
- Data Science pipelines
- AI agents
- LLM automation workflows
- Internal developer tools

The goal of Promptary is to make AI workflows:

- reusable
- versioned
- shareable
- easy to integrate

---

# 📚 Example Use Case

A Data Scientist can:

1. Discover a blueprint in Promptary.
2. Pull it using the CLI or API.
3. Customize the workflow.
4. Integrate it into a notebook or production pipeline.
5. Share improvements back with the community.

Promptary turns AI prompts into reusable engineering assets.

---

# 🎨 Design Philosophy

Promptary is designed for long technical sessions, combining a professional developer experience with a modern AI-native interface.

### Premium Dark Interface
A focused dark environment built with deep grayscale and slate tones, enhanced with subtle purple and emerald accents.

### Developer-Focused Typography
A refined typography system combining:

- Sans-serif fonts for readability and navigation.
- Mono fonts (JetBrains Mono) for:
  - code snippets
  - commands
  - technical metadata
  - development indicators

### Smooth Interaction
Polished animations, transitions, and responsive components create a fluid experience optimized for productivity.

---

# 🚀 Core Features

## 1. Prompt Blueprint Library

A structured catalog of high-quality AI workflows organized around key Data Science domains.

### Exploratory Data Analysis (EDA)
Prompts designed to accelerate:
- dataset understanding
- pattern discovery
- statistical exploration
- visualization workflows

### Data Cleaning
Reusable workflows for:
- missing value handling
- anomaly detection
- outlier analysis
- data normalization

### Machine Learning & Modeling
Prompt architectures for:
- model experimentation
- hyperparameter optimization
- pipeline design
- evaluation strategies

### Debugging & Development
AI-assisted troubleshooting for:
- Python
- SQL
- PyTorch
- ML pipelines
- complex errors

---

# 2. Collaborative Prompt Ecosystem

Inspired by modern software development workflows.

## Fork System

Users can clone existing prompt blueprints and customize them for their own projects.

Each fork maintains:
- original structure
- modifications
- contributor ownership
- evolution history

Turning prompts into reusable community-driven assets.

## Community Publishing

Professionals can publish their own workflows with:

- author information
- role
- tags
- professional links
- technical context

---

# 3. Cloud Architecture & Data Persistence

Promptary combines cloud synchronization with local performance.

## Authentication

Secure developer authentication powered by Firebase Google Auth.

Ensures:
- personalized libraries
- user profiles
- contribution ownership

## Cloud Database

Real-time synchronization using Cloud Firestore.

Features:
- persistent prompt storage
- community contributions
- scalable data structure
- secure access rules

## Personal Library

Users can save favorite prompts locally for fast access through a personalized collection.

---

# 4. AI Development Utilities

Each prompt blueprint includes a detailed inspection environment.

## Code Integration Snippets

Generate ready-to-use examples for:

- Python API calls
- modern AI SDKs
- pip installation commands
- curl requests

Designed for direct integration into:

- Jupyter Notebooks
- development environments
- terminal workflows

---

# 5. Community Ranking System

Promptary uses interaction signals to surface valuable workflows.

Users can provide feedback through:

- 👍 Likes
- 👎 Dislikes

Helping identify:

- trending prompts
- high-performing workflows
- community favorites

---

# Vision

Promptary aims to become the GitHub for AI prompts in Data Science: a place where professionals build, share, improve, and reuse AI knowledge instead of starting from zero every time.
