agnai

Agnaistik

AI Roleplay Obrolan dengan Karakter yang Dipersonalisasi menggunakan layanan AI favorit Anda.

Versi Langsung | Perselisihan

Kunjungi versi langsung di Agnai.chat.

Berdasarkan karya awal Galatea-UI oleh PygmalionAI.

---

Mulai Cepat

Penting! MongoDB dan Redis bersifat opsional! Agnaistic akan berjalan dalam mode "Khusus Tamu" jika MongoDB tidak tersedia.

Agnaistic diterbitkan sebagai paket NPM dan dapat diinstal secara global:

 # Install or update:
npm install agnai -g
agnai

# View launch options:
agnai help

# Run with the Pipeline features
agnai --pipeline

Saat menggunakan paket NPM, gambar dan file JSON Anda akan disimpan di: HOME_FOLDER/.agnai .
Contoh:
Linux: /home/sceuick/.agnai/
Mac: /Users/sceuick/.agnai
Windows: C:Userssceuick.agnai .

Fitur

• Percakapan Grup : Banyak pengguna dengan banyak bot
• Beberapa layanan AI : Dukungan untuk Kobold, Novel, AI Horde, Goose, OpenAI, Claude, Replikasi, OpenRouter, Mancer
• Berbagai format skema persona: W++, Format braket persegi (SBF), Bostyle, Teks biasa
• Multi-sewa:
  • Otentikasi pengguna
  • Pengaturan pengguna: Layanan AI mana yang akan digunakan dan pengaturannya sendiri
  • Preset generasi pengguna
• Langganan
• Buku Memori/Pengetahuan
• Hasilkan karakter dengan AI
• Pembuatan gambar menggunakan layanan pihak ketiga
• Fitur saluran opsional
  • Memori jangka panjang
  • Penyematan Artikel Wikipedia dan PDF

Berjalan Secara Manual

3. Instal Node.js
4. Instal MongoDB Opsional
   • Basis data bersifat opsional. Agnaistic akan berjalan dalam mode anonymous-only jika tidak ada database yang tersedia.
   • Data pengguna Anonymous disimpan di penyimpanan lokal browser. Data Anda akan "tetap ada", tetapi tidak dapat dibagikan antar perangkat atau browser lain. Menghapus data aplikasi/cookie browser Anda akan menghapus data ini.
5. Unduh proyek: git clone https://github.com/agnaistic/agnai atau unduh
6. Dari dalam folder yang dikloning/dibongkar di terminal/konsol Anda:
   • npm run deps
     • Lakukan ini setiap kali Anda memperbarui AgnAI, untuk berjaga-jaga.
     • Ini akan menginstal dependensi menggunakan pnpm v8
   • npm run build:all
   • Bangun dan jalankan proyek dalam mode tontonan:
     • Mac/Linux: npm run start
     • Windows: npm run start:win
   • Bangun dan jalankan proyek dengan Terowongan Lokal:
     • Mac/Linux: npm run start:public
     • Windows: npm run start:public:win

Berjalan dengan Docker

1. Kloning proyek tersebut
2. Dengan MongoDB: docker compose -p agnai -f self-host.docker-compose.yml up -d
3. Tanpa MongoDB: docker run -dt --restart=always -p 3001:3001 ghcr.io/agnaistic/agnaistic:latest
   • -dt Jalankan wadah terpisah
   • --restart=always Restart saat start up atau jika server crash
   • -p 3001:3001 Buka port 3001. Akses aplikasi di http://localhost:3001

Pengaturan Hosting Mandiri

Untuk mencoba dan memenuhi perubahan kecil dan penyetelan yang dibutuhkan orang-orang untuk kebutuhan spesifik mereka di tingkat aplikasi, kami memiliki settings.json .
Anda dapat membuat file bernama settings.json di tingkat root untuk menerapkan beberapa perubahan di seluruh aplikasi.
Jika Anda memiliki kebutuhan khusus untuk aplikasi Anda, ini adalah tempat untuk meminta agar aplikasi tersebut dipenuhi.

Saya akan mencoba dan menemukan keseimbangan antara memenuhi permintaan ini dan tidak membiarkannya lepas kendali dalam basis kode.

Contoh permintaan yang cocok untuk ini:

• Saya ingin "buku memori default" diterapkan ke semua pengguna.
• Saya ingin menggunakan kumpulan token akhir yang berbeda dari yang disediakan.
• Saya ingin menonaktifkan akses anonim

pengaturan.json

Anda dapat menyalin atau melihat template.settings.json untuk melihat contoh semua pengaturan yang tersedia. Anda harus memulai ulang Agnai agar perubahan diterapkan.

Pengaturan khusus yang saat ini didukung:

• baseEndTokens : Tambahkan token akhir respons tambahan ke set dasar.

Untuk Pengembang

Alat Pengembangan yang Direkomendasikan

Saya sangat merekomendasikan menggunakan VSCode dengan ekstensi berikut:

• Prettier - Code formatter : Untuk pemformatan otomatis
• Tailwind CSS Intellisense : Untuk pelengkapan otomatis dan intellisense dengan kelas Tailwind CSS
• Dan menambahkan "editor.formatOnSave": true ke VSCode settings.json Anda untuk memformat otomatis dengan Prettier

Saat menggunakan pnpm start , server Node.JS dijalankan menggunakan --inspect . Ini berarti Anda dapat menggunakan berbagai Klien Inspektur untuk debugging.

Tumpukan Teknologi

Bagian penting dari tumpukan adalah:

• MongoDB untuk ketekunan
• Redis untuk perpesanan terdistribusi untuk soket web.
• SolidJS untuk interaktivitas
• TailwindCSS untuk penataan gaya
• pnpm untuk manajemen ketergantungan

Mulai

 # 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

Pada titik ini, Anda seharusnya dapat mengakses http://localhost:3001 di browser Anda untuk melihat UI.

Anda juga dapat mencoba mengakses frontend dengan hot reload di http://localhost:1234

Alat Pengembang yang Direkomendasikan

• Alat Pengembang Redux
  • Status aplikasi front-end dihubungkan ke ekstensi Chrome "Redux Dev Tools".
• debugger NodeJS
  • Skrip pnpm start meluncurkan API NodeJS menggunakan flag --inspect
  • Lampirkan menggunakan tugas peluncuran default di VSCode ( F5 )
  • Atau buka url chrome://inspect untuk menggunakan debugger
• Manajemen ketergantungan Python menggunakan Poetry - https://python-poetry.org/docs/cli
  • .model/bin/poetry [...args]

Pemeriksaan Format dan Jenis

Proyek ini menggunakan ESLint untuk linting, Prettier untuk menerapkan gaya kode, dan TypeScript untuk memeriksa kesalahan ketik. Saat membuka PR, pastikan Anda tidak menimbulkan kesalahan baru dalam pemeriksaan berikut dengan menjalankan:

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

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

Proyek ini diuji dengan BrowserStack.