agnai

агнаистический

Ролевая игра с искусственным интеллектом. Общайтесь с персонализированными персонажами, используя ваши любимые службы искусственного интеллекта.

Живая версия | Раздор

Посетите живую версию на Agnai.chat.

На основе ранней работы Galatea-UI от PygmalionAI.

---

Быстрый старт

Важный! MongoDB и Redis не являются обязательными! Agnaistic будет работать в гостевом режиме, если MongoDB недоступна.

Agnaistic публикуется как пакет NPM и может быть установлен глобально:

 # Install or update:
npm install agnai -g
agnai

# View launch options:
agnai help

# Run with the Pipeline features
agnai --pipeline

При использовании пакета NPM ваши изображения и файлы JSON будут храниться в папке HOME_FOLDER/.agnai .
Примеры:
Linux: /home/sceuick/.agnai/
Mac: /Users/sceuick/.agnai
Windows: C:Userssceuick.agnai .

Функции

• Групповые беседы : несколько пользователей с несколькими ботами
• Несколько служб искусственного интеллекта : поддержка Kobold, Novel, AI Horde, Goose, OpenAI, Claude, Replication, OpenRouter, Mancer.
• Несколько форматов схем персон: W++, формат квадратных скобок (SBF), Boostyle, обычный текст.
• Мультиарендность:
  • Аутентификация пользователя
  • Пользовательские настройки: какой AI-сервис использовать и собственные настройки.
  • Пресеты генерации пользователей
• Подписки
• Книги памяти/предположений
• Генерируйте персонажей с помощью ИИ
• Генерация изображений с помощью сторонних сервисов
• Дополнительные функции конвейера
  • Долговременная память
  • Статьи Википедии и встраивание PDF-файлов

Запуск вручную

3. Установите Node.js
4. Установите MongoDB (необязательно)
   • База данных не является обязательной. Agnaistic будет работать anonymous-only режиме, если доступная база данных отсутствует.
   • Данные Anonymous пользователей сохраняются в локальном хранилище браузера. Ваши данные будут «сохраняться», но не будут доступны для совместного использования между устройствами или другими браузерами. Очистка данных приложения/файлов cookie вашего браузера приведет к удалению этих данных.
5. Загрузите проект: git clone https://github.com/agnaistic/agnai или скачайте его.
6. Из клонированной/распакованной папки вашего терминала/консоли:
   • npm run deps
     • На всякий случай делайте это каждый раз, когда обновляете AgnAI.
     • Это установит зависимости с помощью pnpm v8
   • npm run build:all
   • Соберите и запустите проект в режиме просмотра:
     • Mac/Linux: npm run start
     • Windows: npm run start:win
   • Создайте и запустите проект с помощью Local Tunnel:
     • Mac/Linux: npm run start:public
     • Windows: npm run start:public:win

Запуск с Docker

1. Клонировать проект
2. С MongoDB: docker compose -p agnai -f self-host.docker-compose.yml up -d
3. Без MongoDB: docker run -dt --restart=always -p 3001:3001 ghcr.io/agnaistic/agnaistic:latest
   • -dt Запустить отсоединенный контейнер
   • --restart=always Перезапускать при запуске или в случае сбоя сервера
   • -p 3001:3001 Открыть порт 3001. Доступ к приложению осуществляется по адресу http://localhost:3001

Настройки самостоятельного хостинга

Чтобы попытаться удовлетворить небольшие изменения и настройки, необходимые людям для их конкретных потребностей на уровне приложения, у нас есть settings.json .
Вы можете создать файл с именем settings.json на корневом уровне, чтобы применить некоторые изменения ко всему приложению.
Если у вас есть особые потребности в вашем приложении, это место, где вы можете попросить об их удовлетворении.

Я постараюсь найти баланс между удовлетворением этих запросов и предотвращением выхода их из-под контроля в кодовой базе.

Примеры запросов, которые для этого подходят:

• Я хочу, чтобы «книга памяти по умолчанию» применялась ко всем пользователям.
• Я хочу использовать набор конечных токенов, отличный от предоставленного.
• Я хочу отключить анонимный доступ

settings.json

Вы можете скопировать или просмотреть template.settings.json чтобы увидеть пример всех доступных настроек. Вам нужно будет перезапустить Agnai, чтобы изменения вступили в силу.

В настоящее время поддерживаются пользовательские настройки:

• baseEndTokens : добавьте дополнительные токены завершения ответа в базовый набор.

Для разработчиков

Рекомендуемые инструменты разработки

Я настоятельно рекомендую использовать VSCode со следующими расширениями:

• Prettier - Code formatter : для автоматического форматирования.
• Tailwind CSS Intellisense : для автозаполнения и интеллекта с классами Tailwind CSS.
• И добавление "editor.formatOnSave": true в ваш settings.json VSCode для автоматического форматирования с помощью Prettier.

При использовании pnpm start сервер Node.JS запускается с использованием --inspect . Это означает, что вы можете использовать различные клиенты Inspector для отладки.

Технический стек

Важными частями стека являются:

• MongoDB для постоянства
• Redis для распределенного обмена сообщениями для веб-сокетов.
• SolidJS для интерактивности
• TailwindCSS для стилизации
• pnpm для управления зависимостями

Начало

 # 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

На этом этапе у вас должен быть доступ к http://localhost:3001 в вашем браузере, чтобы увидеть пользовательский интерфейс.

Вы также можете попробовать получить доступ к интерфейсу с горячей перезагрузкой по адресу http://localhost:1234.

Рекомендуемые инструменты разработчика

• Инструменты разработки Redux
  • Состояние внешнего приложения связано с расширением Chrome «Redux Dev Tools».
• NodeJS-отладчик
  • Сценарий pnpm start запускает NodeJS API с использованием флага --inspect
  • Прикрепите, используя задачу запуска по умолчанию в VSCode ( F5 )
  • Или перейдите по URL-адресу chrome://inspect чтобы использовать отладчик.
• Управление зависимостями Python с помощью Poetry – https://python-poetry.org/docs/cli
  • .model/bin/poetry [...args]

Проверка формата и типа

В проекте используется ESLint для проверки, Prettier для обеспечения соблюдения стиля кода и TypeScript для проверки ошибок типа. При открытии PR убедитесь, что вы не создаете новых ошибок ни в одной из этих проверок, выполнив:

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

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

Этот проект протестирован с помощью BrowserStack.