@personnn/personnnkit

v1.0.1

Published

a year ago

🇵 PersonnnKit - El Agente Kit Universal. Framework revolucionario para crear agentes de IA con HTML + Python. Simplicidad radical vs frameworks gigantes.

Downloads

🇵 PersonnnKit - El Agente Kit Universal

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 • 📚 Documentación • 🤖 Ejemplos • 💡 Filosofía

🧠 ¿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

npm install -g @personnn/personnnkit

Crear tu primer agente

# 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:

personnnkit --help

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

   ╔══════════════════════════ 🇵 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                   ║
   ║                                                                    ║
   ╚════════════════════════════════════════════════════════════════════╝

🔧 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

<!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

#!/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

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

npm run dev

Producción

npm run build
# Despliega la carpeta dist/

Docker (Opcional)

FROM node:18
COPY . .
RUN npm install
CMD ["npm", "run", "dev"]

📚 Documentación

🤝 Contribuir

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

Fork el repositorio
Edita los archivos directamente
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

🇵 PersonnnKit

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