agnai

Agnaistique

Chat de rôle IA avec des personnages personnalisés en utilisant vos services d'IA préférés.

Version en direct | Discorde

Visitez la version en direct sur Agnai.chat.

Basé sur les premiers travaux de Galatea-UI par PygmalionAI.

---

Démarrage rapide

Important! MongoDB et Redis sont facultatifs ! Agnaistic fonctionnera en mode "Invité uniquement" si MongoDB n'est pas disponible.

Agnaistic est publié sous forme de package NPM et peut être installé globalement :

 # Install or update:
npm install agnai -g
agnai

# View launch options:
agnai help

# Run with the Pipeline features
agnai --pipeline

Lorsque vous utilisez le package NPM, vos images et fichiers JSON seront stockés dans : HOME_FOLDER/.agnai .
Exemples :
Linux : /home/sceuick/.agnai/
Mac : /Users/sceuick/.agnai
Windows : C:Userssceuick.agnai .

Caractéristiques

• Conversations de groupe : plusieurs utilisateurs avec plusieurs robots
• Services d'IA multiples : prise en charge de Kobold, Novel, AI Horde, Goose, OpenAI, Claude, Replicate, OpenRouter, Mancer
• Plusieurs formats de schémas personnels : W++, format entre crochets (SBF), Boostyle, texte brut
• Multilocation :
  • Authentification de l'utilisateur
  • Paramètres utilisateur : quel service d'IA utiliser et leurs propres paramètres
  • Préréglages de génération d'utilisateurs
• Abonnements
• Livres de mémoire/savoir
• Générez des personnages avec l'IA
• Génération d'images à l'aide de services tiers
• Fonctionnalités facultatives du pipeline
  • Mémoire à long terme
  • Article Wikipédia et intégration de PDF

Exécution manuelle

3. Installer Node.js
4. Installer MongoDB en option
   • La base de données est facultative. Agnaistic s'exécutera en mode anonymous-only si aucune base de données n'est disponible.
   • Les utilisateurs Anonymous voient leurs données enregistrées dans le stockage local du navigateur. Vos données « persisteront », mais ne pourront pas être partagées entre appareils ou autres navigateurs. La suppression des données d'application/cookies de votre navigateur supprimera ces données.
5. Téléchargez le projet : git clone https://github.com/agnaistic/agnai ou téléchargez-le
6. Depuis le dossier cloné/décompressé de votre terminal/console :
   • npm run deps
     • Faites-le à chaque fois que vous mettez à jour AgnAI, juste au cas où.
     • Cela installera les dépendances en utilisant pnpm v8
   • npm run build:all
   • Créez et exécutez le projet en mode surveillance :
     • Mac/Linux : npm run start
     • Windows : npm run start:win
   • Créez et exécutez le projet avec Local Tunnel :
     • Mac/Linux : npm run start:public
     • Windows : npm run start:public:win

Exécuter avec Docker

1. Cloner le projet
2. Avec MongoDB : docker compose -p agnai -f self-host.docker-compose.yml up -d
3. Sans MongoDB : docker run -dt --restart=always -p 3001:3001 ghcr.io/agnaistic/agnaistic:latest
   • -dt Exécuter le conteneur détaché
   • --restart=always Redémarrer au démarrage ou si le serveur plante
   • -p 3001:3001 Expose le port 3001. Accédez à l'application à http://localhost:3001

Paramètres d'auto-hébergement

Pour essayer de répondre aux petits ajustements et réglages dont les utilisateurs ont besoin pour leurs besoins spécifiques au niveau de l'application, nous avons settings.json .
Vous pouvez créer un fichier appelé settings.json au niveau racine pour appliquer certaines modifications à l'ensemble de l'application.
Si vous avez un besoin spécifique pour votre candidature, c'est ici qu'il faut demander à ce qu'il soit pris en charge.

Je vais essayer de trouver un équilibre entre répondre à ces demandes et ne pas les rendre incontrôlables dans la base de code.

Exemples de demandes adaptées à cela :

• Je souhaite un "livre mémoire par défaut" appliqué à tous les utilisateurs.
• Je souhaite utiliser un ensemble de jetons de fin différent de ceux fournis.
• Je souhaite désactiver l'accès anonyme

paramètres.json

Vous pouvez copier ou consulter template.settings.json pour un exemple de tous les paramètres disponibles. Vous devrez redémarrer Agnai pour que les modifications prennent effet.

Paramètres personnalisés actuellement pris en charge :

• baseEndTokens : ajoutez des jetons de fin de réponse supplémentaires à l'ensemble de base.

Pour les développeurs

Outils de développement recommandés

Je recommande fortement d'utiliser VSCode avec les extensions suivantes :

• Prettier - Code formatter : Pour le formatage automatique
• Tailwind CSS Intellisense : Pour la complétion automatique et l'intellisense avec les classes CSS Tailwind
• Et en ajoutant "editor.formatOnSave": true à votre VSCode settings.json pour formater automatiquement avec Prettier

Lors de l'utilisation pnpm start , le serveur Node.JS est exécuté en utilisant --inspect . Cela signifie que vous pouvez utiliser différents clients Inspector pour le débogage.

Pile technologique

Les parties importantes de la pile sont :

• MongoDB pour la persistance
• Redis pour la messagerie distribuée pour les websockets.
• SolidJS pour l'interactivité
• TailwindCSS pour le style
• pnpm pour la gestion des dépendances

Départ

 # 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

À ce stade, vous devriez pouvoir accéder à http://localhost:3001 dans votre navigateur pour voir l'interface utilisateur.

Vous pouvez également essayer d'accéder au frontend avec un rechargement à chaud sur http://localhost:1234

Outils de développement recommandés

• Outils de développement Redux
  • L’état de l’application frontale est connecté à l’extension Chrome « ​​Redux Dev Tools ».
• Débogueur NodeJS
  • Le script pnpm start lance l'API NodeJS à l'aide de l'indicateur --inspect
  • Attacher à l'aide de la tâche de lancement par défaut dans VSCode ( F5 )
  • Ou allez sur l'url chrome://inspect pour utiliser le débogueur
• Gestion des dépendances Python à l'aide Poetry - https://python-poetry.org/docs/cli
  • .model/bin/poetry [...args]

Vérification du format et du type

Le projet utilise ESLint pour le peluchage, Prettier pour appliquer le style de code et TypeScript pour vérifier les erreurs de type. Lors de l'ouverture d'un PR, assurez-vous de ne pas introduire de nouvelles erreurs dans aucune de ces vérifications en exécutant :

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

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

Ce projet est testé avec BrowserStack.