agnai

agnaísta

Chat de juegos de rol de IA con personajes personalizados utilizando tus servicios de IA favoritos.

Versión en vivo | Discordia

Visite la versión en vivo en Agnai.chat.

Basado en los primeros trabajos de Galatea-UI de PygmalionAI.

---

Inicio rápido

¡Importante! ¡MongoDB y Redis son opcionales! Agnaistic se ejecutará en modo "Sólo para invitados" si MongoDB no está disponible.

Agnaistic se publica como un paquete NPM y se puede instalar globalmente:

 # Install or update:
npm install agnai -g
agnai

# View launch options:
agnai help

# Run with the Pipeline features
agnai --pipeline

Cuando utilice el paquete NPM, sus imágenes y archivos JSON se almacenarán en: HOME_FOLDER/.agnai .
Ejemplos:
Linux: /home/sceuick/.agnai/
Mac: /Users/sceuick/.agnai
Windows: C:Userssceuick.agnai .

Características

• Conversaciones grupales : múltiples usuarios con múltiples bots
• Múltiples servicios de IA : soporte para Kobold, Novel, AI Horde, Goose, OpenAI, Claude, Replicate, OpenRouter, Mancer
• Múltiples formatos de esquema de persona: W++, formato de corchete (SBF), Boostyle, texto sin formato
• Multiinquilino:
  • Autenticación de usuario
  • Configuración del usuario: qué servicio de IA usar y su propia configuración
  • Ajustes preestablecidos de generación de usuarios
• Suscripciones
• Libros de memoria/conocimientos
• Genera personajes con IA
• Generación de imágenes utilizando servicios de terceros.
• Características opcionales de la tubería
  • Memoria a largo plazo
  • Artículo de Wikipedia e incrustación de PDF

Ejecutando manualmente

3. Instalar Node.js
4. Instalar MongoDB Opcional
   • La base de datos es opcional. Agnaistic se ejecutará en modo anonymous-only si no hay una base de datos disponible.
   • Los datos de los usuarios Anonymous se guardan en el almacenamiento local del navegador. Sus datos "persistirán", pero no se podrán compartir entre dispositivos u otros navegadores. Al borrar los datos/cookies de la aplicación de su navegador se eliminarán estos datos.
5. Descarga el proyecto: git clone https://github.com/agnaistic/agnai o descárgalo
6. Desde dentro de la carpeta clonada/descomprimida en su terminal/consola:
   • npm run deps
     • Haga esto cada vez que actualice AgnAI, por si acaso.
     • Esto instalará las dependencias usando pnpm v8
   • npm run build:all
   • Construya y ejecute el proyecto en modo de observación:
     • Mac/Linux: npm run start
     • Windows: npm run start:win
   • Construya y ejecute el proyecto con Local Tunnel:
     • Mac/Linux: npm run start:public
     • Windows: npm run start:public:win

Ejecutando con Docker

1. Clonar el proyecto
2. Con MongoDB: docker compose -p agnai -f self-host.docker-compose.yml up -d
3. Sin MongoDB: docker run -dt --restart=always -p 3001:3001 ghcr.io/agnaistic/agnaistic:latest
   • -dt Ejecuta el contenedor separado.
   • --restart=always reiniciar al iniciar o si el servidor falla
   • -p 3001:3001 Exponer el puerto 3001. Acceda a la aplicación en http://localhost:3001

Configuración de autohospedaje

Para intentar atender los pequeños ajustes y ajustes que las personas necesitan para sus necesidades específicas a nivel de aplicación, tenemos settings.json .
Puede crear un archivo llamado settings.json en el nivel raíz para aplicar algunos cambios en toda la aplicación.
Si tiene una necesidad específica para su aplicación, este es el lugar para solicitar que la atiendan.

Intentaré encontrar un equilibrio entre atender estas solicitudes y evitar que se salgan de control en el código base.

Ejemplos de solicitudes adecuadas para esto:

• Quiero que se aplique un "libro de memoria predeterminado" a todos los usuarios.
• Quiero utilizar un conjunto de tokens finales diferente al proporcionado.
• Quiero desactivar el acceso anónimo

configuración.json

Puede copiar o mirar template.settings.json para ver un ejemplo de todas las configuraciones disponibles. Deberá reiniciar Agnai para que los cambios surtan efecto.

Configuraciones personalizadas actualmente admitidas:

• baseEndTokens : agrega tokens de finalización de respuesta adicionales al conjunto base.

Para desarrolladores

Herramientas de desarrollo recomendadas

Recomiendo encarecidamente usar VSCode con las siguientes extensiones:

• Prettier - Code formatter : Para formato automático
• Tailwind CSS Intellisense : para autocompletado e intellisense con clases de Tailwind CSS
• Y agregando "editor.formatOnSave": true a su VSCode settings.json para formatear automáticamente con Prettier

Cuando se usa pnpm start , el servidor Node.JS se ejecuta usando --inspect . Esto significa que puede utilizar varios clientes Inspector para depurar.

Pila de tecnología

Las partes importantes de la pila son:

• MongoDB para persistencia
• Redis para mensajería distribuida para websockets.
• SolidJS para interactividad
• TailwindCSS para diseñar
• pnpm para gestión de dependencias

A partir de

 # Install dependencies - Always run this after pulling changes
> npm run deps

# Run MongoDB using Docker
> npm run up

# Start the frontend, backend, and python service
# Mac/Linux
> npm start

# Windows
> npm run start:win

# Install and run Pipeline API
# If required, this will update the dependencies before running the API
> npm run model # Install poetry into a virtual environment

# Run everything with a single command:
> npm run start:all # Linux and OSX
> npm run start:all:win # Windows

En este punto, debería poder acceder a http://localhost:3001 en su navegador para ver la interfaz de usuario.

También puedes intentar acceder a la interfaz con recarga en caliente en http://localhost:1234

Herramientas de desarrollador recomendadas

• Herramientas de desarrollo de Redux
  • El estado de la aplicación front-end está conectado a la extensión de Chrome "Redux Dev Tools".
• Depurador de NodeJS
  • El script pnpm start inicia la API de NodeJS usando el indicador --inspect
  • Adjunte usando la tarea de inicio predeterminada en VSCode ( F5 )
  • O vaya a la URL chrome://inspect para usar el depurador
• Gestión de dependencias de Python usando Poetry : https://python-poetry.org/docs/cli
  • .model/bin/poetry [...args]

Comprobación de formato y tipo

El proyecto utiliza ESLint para linting, Prettier para aplicar el estilo del código y TypeScript para comprobar si hay errores tipográficos. Al abrir un PR, asegúrese de no introducir ningún error nuevo en ninguna de estas comprobaciones ejecutando:

 # auto-fixes any style problems
$ pnpm run format:fix

# runs the TypeScript compiler so any type errors will be shown
$ pnpm run typecheck

Este proyecto se prueba con BrowserStack.