@personnn/personnnkit
Version:
🇵 PersonnnKit - El Agente Kit Universal. Framework revolucionario para crear agentes de IA con HTML + Python. Simplicidad radical vs frameworks gigantes.
298 lines (221 loc) • 9.93 kB
Markdown
# 🇵 PersonnnKit - El Agente Kit Universal
<div align="center">
[](https://www.npmjs.com/package/@personnn/personnnkit)
[](https://www.npmjs.com/package/@personnn/personnnkit)
[](https://github.com/azomland/personnnkit/blob/main/LICENSE)
[](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."*
[](https://github.com/azomland/personnnkit)
[](https://www.npmjs.com/package/@personnn/personnnkit)
[](https://discord.gg/personnnkit)
**Construido con ❤️ por el equipo Personnn**
</div>