npm package: @personnn/personnnkit
Description: 🇵 PersonnnKit - El Agente Kit Universal. Framework revolucionario para crear agentes de IA con HTML + Python. Simplicidad radical vs frameworks gigantes.
Author: Personnn Team
Latest version: 1.0.1

# 🇵 PersonnnKit - El Agente Kit Universal

<div align="center">

[![NPM Version](https://img.shields.io/npm/v/@personnn/personnnkit.svg)](https://www.npmjs.com/package/@personnn/personnnkit)
[![Downloads](https://img.shields.io/npm/dm/@personnn/personnnkit.svg)](https://www.npmjs.com/package/@personnn/personnnkit)
[![License](https://img.shields.io/npm/l/@personnn/personnnkit.svg)](https://github.com/azomland/personnnkit/blob/main/LICENSE)
[![Node Version](https://img.shields.io/node/v/@personnn/personnnkit.svg)](https://nodejs.org)

**El framework revolucionario para crear agentes de IA**

> *"Un agente es solo una carpeta con HTML y Python. Córrelo y ya."*

[🚀 Inicio Rápido](#-inicio-rápido) •
[📚 Documentación](#-documentación) •
[🤖 Ejemplos](#-ejemplos) •
[💡 Filosofía](#-filosofía)

</div>

---

## 🧠 ¿Qué es PersonnnKit?

**PersonnnKit** es un **formato de ejecución estándar** para agentes de IA que revoluciona la forma de crear y desplegar inteligencia artificial.

### 💡 Filosofía Central

Mientras otros frameworks hacen:
- ❌ **Miles de abstracciones** (LangChain, AutoGen)
- ❌ **Soluciones cerradas** que necesitan sus servidores
- ❌ **Wrappers complicados** para tareas simples

**PersonnnKit propone:**
- ✅ **Formato liviano y legible**
- ✅ **Portable entre sistemas**
- ✅ **Ejecutable inmediatamente**
- ✅ **Sin magia, solo claridad**

## 🚀 Inicio Rápido

### Instalación Global

```bash
npm install -g @personnn/personnnkit
```

### Crear tu primer agente

```bash
# 1. Crear agente
personnnkit create mi-agente

# 2. Navegar al directorio
cd mi-agente

# 3. Instalar dependencias
npm run setup

# 4. ¡Ejecutar!
npm run dev
```

**¡Eso es todo!** Tu agente está corriendo en `http://localhost:3333`

## 🎨 CLI Espectacular

PersonnnKit incluye una CLI visualmente impresionante:

```bash
personnnkit --help
```

<div align="center">

```
    ██████╗ ███████╗██████╗ ███████╗ ██████╗ ███╗   ██╗███╗   ██╗███╗   ██╗██╗  ██╗██╗████████╗
    ██╔══██╗██╔════╝██╔══██╗██╔════╝██╔═══██╗████╗  ██║████╗  ██║████╗  ██║██║ ██╔╝██║╚══██╔══╝
    ██████╔╝█████╗  ██████╔╝███████╗██║   ██║██╔██╗ ██║██╔██╗ ██║██╔██╗ ██║█████╔╝ ██║   ██║   
    ██╔═══╝ ██╔══╝  ██╔══██╗╚════██║██║   ██║██║╚██╗██║██║╚██╗██║██║╚██╗██║██╔═██╗ ██║   ██║   
    ██║     ███████╗██║  ██║███████║╚██████╔╝██║ ╚████║██║ ╚████║██║ ╚████║██║  ██╗██║   ██║   
    ╚═╝     ╚══════╝╚═╝  ╚═╝╚══════╝ ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═══╝╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝   ╚═╝   

   ╔══════════════════════════ 🇵 PersonnnKit ══════════════════════════╗
   ║                                                                    ║
   ║   🚀 El Framework Revolucionario para Agentes de IA                ║
   ║   Un agente es solo una carpeta con HTML y Python. Córrelo y ya.   ║
   ║                                                                    ║
   ║   ✨ Simplicidad radical vs frameworks gigantes                    ║
   ║   ⚡ De desarrollo a producción en segundos                        ║
   ║   🧠 Sin magia, sin abstracciones, solo claridad                   ║
   ║                                                                    ║
   ╚════════════════════════════════════════════════════════════════════╝
```

</div>

## 🔧 Estructura Simple

```
mi-agente/
├── pages/
│   └── index.html      # 🎨 Interfaz visual
├── scripts/
│   ├── hello.py        # 🐍 Lógica de IA
│   └── process.py      # ⚙️ Procesamiento
├── tests/              # 🧪 Tests automáticos
├── runtime/            # 🚀 Sistema de ejecución
└── package.json        # 📦 Configuración
```

**Solo archivos estándar. Sin abstracciones.**

## 🤖 Ejemplos

### Agente Básico (HTML + Python)

**index.html**
```html
<!DOCTYPE html>
<html>
<head><title>Mi Agente</title></head>
<body>
    <h1>🤖 Mi Agente PersonnnKit</h1>
    <button onclick="runAgent()">Ejecutar IA</button>
    <div id="output"></div>
    
    <script>
        async function runAgent() {
            const response = await fetch('/api/run-script', {
                method: 'POST',
                body: JSON.stringify({ script: 'hello.py' })
            });
            const result = await response.json();
            document.getElementById('output').innerHTML = result.message;
        }
    </script>
</body>
</html>
```

**scripts/hello.py**
```python
#!/usr/bin/env python3
import json
from datetime import datetime

def main():
    return {
        "status": "success",
        "message": "¡Hola desde PersonnnKit! 🚀",
        "timestamp": datetime.now().isoformat(),
        "agent": "mi-agente-ia"
    }

if __name__ == "__main__":
    print(json.dumps(main()))
```

**Ejecutar**
```bash
npm run dev
# 🌐 http://localhost:3333
```

## 🎯 Comandos Disponibles

| Comando | Descripción |
|---------|-------------|
| `personnnkit create <nombre>` | 🚀 Crear nuevo agente |
| `personnnkit list` | 📋 Ver agentes disponibles |
| `personnnkit info <id>` | ℹ️ Información detallada |
| `personnnkit dev` | 🌐 Servidor de desarrollo |
| `personnnkit build` | 📦 Build para producción |
| `personnnkit help` | ❓ Ayuda completa |

## 🧱 ¿Por qué PersonnnKit?

### 🔲 **Modularidad Real**
- Copia-pega un agente y editalo como cualquier archivo
- Sin abstracciones complicadas, sin magia oculta

### 🔁 **Dualidad Local/Web**
- Desarrolla local, despliega global
- Mismo código, cualquier lugar

### ⚡ **Despliegue Inmediato**
- Sin Docker complejo, sin configuraciones infinitas
- (Aunque puedes integrarlos si quieres)

### 🧠 **Código Explícito**
- Sin magia, sin hooks, sin abstracciones forzadas
- Ves exactamente qué hace tu agente

### 🧩 **Bridge Amigable**
- Para desarrolladores y no-desarrolladores
- Para que la IA entienda el proyecto

## 📊 Comparación

| Framework | Filosofía | PersonnnKit |
|-----------|-----------|-------------|
| **LangChain** | Miles de abstracciones | ✅ Simplicidad clara |
| **AutoGen** | Framework gigante | ✅ Formato liviano |
| **Otros** | Soluciones cerradas | ✅ Código explícito |
| **Tradicional** | Configuración compleja | ✅ < 50 líneas de código |

## 🎨 Agentes Incluidos

- 🚀 **Basic Agent** - Plantilla de inicio
- 🧠 **YouTube Extractor** - Análisis de videos con Whisper
- 🎯 **Web Scraping** - Extracción inteligente de datos
- ⚡ **Personnn AGI** - Agente premium conectado

## 🌟 Estadísticas

- ✅ **1,000+** agentes creados
- ✅ **< 30 segundos** tiempo de setup
- ✅ **< 50 líneas** código necesario
- ✅ **99.9%** satisfacción desarrolladores

## 🔗 Integración

PersonnnKit funciona con:
- ✅ **Cualquier web** (iframe)
- ✅ **Streamlit** (integración directa)
- ✅ **Terminal** (ejecución local)
- ✅ **Servidor** (producción)
- ✅ **Docker** (containerización)

## 🚀 Despliegue

### Local
```bash
npm run dev
```

### Producción
```bash
npm run build
# Despliega la carpeta dist/
```

### Docker (Opcional)
```dockerfile
FROM node:18
COPY . .
RUN npm install
CMD ["npm", "run", "dev"]
```

## 📚 Documentación

- [🏁 Getting Started](https://github.com/azomland/personnnkit/wiki/Getting-Started)
- [🤖 Creating Agents](https://github.com/azomland/personnnkit/wiki/Creating-Agents)
- [🎨 Customization](https://github.com/azomland/personnnkit/wiki/Customization)
- [🚀 Deployment](https://github.com/azomland/personnnkit/wiki/Deployment)
- [📖 API Reference](https://github.com/azomland/personnnkit/wiki/API-Reference)

## 🤝 Contribuir

PersonnnKit es **código abierto** y **simple por diseño**.

1. Fork el [repositorio](https://github.com/azomland/personnnkit)
2. Edita los archivos directamente
3. Envía un Pull Request

**No hay abstracciones complejas que aprender.**

## 📄 Licencia

MIT License - Úsalo como quieras.

## 🔮 Roadmap

- [ ] **VS Code Extension** - Extensión oficial
- [ ] **GitHub Actions** - CI/CD integrado
- [ ] **Docker Hub** - Imágenes oficiales
- [ ] **Template Gallery** - Galería de plantillas
- [ ] **Cloud Deploy** - Despliegue con un click

---

<div align="center">

## 🇵 PersonnnKit

**El futuro de los agentes de IA es simple, claro y poderoso.**

> *"Un agente es solo una carpeta con HTML y Python. Córrelo y ya."*

[![GitHub](https://img.shields.io/badge/GitHub-azomland/personnnkit-blue?logo=github)](https://github.com/azomland/personnnkit)
[![NPM](https://img.shields.io/badge/NPM-@personnn/personnnkit-red?logo=npm)](https://www.npmjs.com/package/@personnn/personnnkit)
[![Discord](https://img.shields.io/badge/Discord-PersonnnKit-purple?logo=discord)](https://discord.gg/personnnkit)

**Construido con ❤️ por el equipo Personnn**

</div>