Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@personnn/personnnkit) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🇵 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.

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

Construido con ❤️ por el equipo Personnn