# ๐Ÿ‡ต PersonnnKit - El Agente Kit Universal
[![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)
--- ## ๐Ÿง  ยฟ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 ```
``` โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•”โ•โ•โ•โ•โ•โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•”โ•โ•โ•โ•โ•โ–ˆโ–ˆโ•”โ•โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•‘โ•šโ•โ•โ–ˆโ–ˆโ•”โ•โ•โ• โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ• โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•”โ•โ•โ•โ• โ–ˆโ–ˆโ•”โ•โ•โ• โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ•šโ•โ•โ•โ•โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ•šโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ•šโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ•šโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•‘ โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘ โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘ โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘ โ•šโ•โ• โ•šโ•โ•โ•โ•โ•โ•โ•โ•šโ•โ• โ•šโ•โ•โ•šโ•โ•โ•โ•โ•โ•โ• โ•šโ•โ•โ•โ•โ•โ• โ•šโ•โ• โ•šโ•โ•โ•โ•โ•šโ•โ• โ•šโ•โ•โ•โ•โ•šโ•โ• โ•šโ•โ•โ•โ•โ•šโ•โ• โ•šโ•โ•โ•šโ•โ• โ•šโ•โ• โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• ๐Ÿ‡ต 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** ```html Mi Agente

๐Ÿค– Mi Agente PersonnnKit

``` **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 ` | ๐Ÿš€ Crear nuevo agente | | `personnnkit list` | ๐Ÿ“‹ Ver agentes disponibles | | `personnnkit info ` | โ„น๏ธ 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 ---
## ๐Ÿ‡ต 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**