artbot

ArtBot

Une interface graphique frontale pour interagir avec le cluster distribué de travailleurs de diffusion stable d'AI Horde.

Table des matières

• Introduction
• Installation
  • Exigences
  • Installation
• Usage
  • Développement
  • Production
• Cotisations
• Remerciements

Introduction

ArtBot est un client Web frontal conçu pour interagir avec le cluster distribué open source AI Horde, un groupe de GPU exécutant Stable Diffusion dont le temps de traitement a été aimablement offert par une communauté enthousiaste de bénévoles.

ArtBot est construit à l'aide de Next.js 14 et Typescript. Il utilise des technologies côté client telles que les API IndexedDB et LocalStorage afin de stocker de manière sécurisée et privée les images générées par l'IA que vous avez créées à l'aide du cluster dans votre propre navigateur Web.

Installation

Exigences

• nœud >= 18.18.0
• npm >= 9.5.1

La plupart de ces étapes devraient être applicables aux environnements Linux, MacOS ou Windows.

L'installation de différentes versions de Node.js sur votre machine peut être délicate. Je suis un grand fan de nvm, qui vous permet d'exécuter facilement plusieurs versions isolées de Node.js sur votre machine.

En utilisant nvm , vous pouvez installer Node comme ceci :

 > nvm install v18.18.0
> nvm alias default node
> node -v # Checks which version of Node is currently running

Installation

Une fois que vous avez configuré votre environnement Node.js, vous pouvez cloner ce référentiel et installer les packages requis. Selon les spécifications de votre machine et la vitesse de votre connexion Internet, l'installation de tous les packages peut prendre une minute ou deux.

 > git clone https://github.com/Haidra-Org/artbot.git
> cd artbot
> npm install

Usage

Développement

Très bien, vous devriez maintenant pouvoir exécuter l'application Web ArtBot ! Pour exécuter en mode développement (qui utilise la fonctionnalité de rechargement à chaud de NextJS - où vous pouvez voir les mises à jour en direct sur le site lorsque vous apportez des modifications)

 > npm run dev

Ensuite, ouvrez votre navigateur et visitez http://localhost:3000 , vous devriez maintenant pouvoir immédiatement faire des demandes d'images à la Horde Stable. Rendez-vous sur http://localhost:3000/settings et entrez votre clé API Stable Horde pour des temps de génération plus rapides.

Production

ArtBot est construit en utilisant le mode autonome de Next.JS. Cela génère le projet sur ./next/standalone . L'idée est que ce dossier peut être compressé et téléchargé partout où vous en avez besoin pour servir le projet.

Après avoir exécuté npm run build , vous devrez exécuter npm run postbuild afin de copier les ressources statiques et le dossier public (NextJS ne le fait pas automatiquement, car ce genre de choses doit généralement être téléchargé sur un CDN). Si vous oubliez d'exécuter le script postbuild , il manquera à ArtBot des images et des styles CSS.

 > npm run build
> npm run postbuild # copies public folder
> cd ./next/standalone
> node server.js

Cotisations

Les contributions sont les bienvenues ! Les directives générales sont les suivantes :

1. Forkez ce référentiel
2. Coupez une nouvelle branche de fonctionnalités. par exemple, > git checkout -b feat/my-cool-new-feature
3. Apportez toutes les modifications nécessaires et validez votre code ! (Si possible, utilisez des commits conventionnels)
4. Ouvrez une nouvelle pull request basée sur votre branche de fonctionnalités.

Faites-moi savoir si vous avez des questions. Je suis plus qu'heureux de vous aider.

Remerciements

ArtBot utilise un certain nombre de ressources fournies par des concepteurs et des développeurs qui mettent leur travail à disposition gratuitement. Sans ces outils, ArtBot et bien d’autres projets sur Internet ne pourraient exister. Nous sommes très reconnaissants !

• "Icône gratuite AI" via Flaticon - utilisée pour le logo ArtBot
• Suivant.js
• Statery - Gestion simple de l'état global
• Icônes de table
• CSS vent arrière