agnai

불가신적인

AI 역할극 좋아하는 AI 서비스를 사용하여 맞춤형 캐릭터와 채팅하세요.

라이브 버전 | 불화

Agnai.chat에서 라이브 버전을 방문하세요.

PygmalionAI의 Galatea-UI 초기 작업을 기반으로 합니다.

---

빠른 시작

중요한! MongoDB와 Redis는 선택 사항입니다! MongoDB를 사용할 수 없는 경우 Agnaistic은 "게스트 전용" 모드로 실행됩니다.

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 에 저장됩니다.
예:
리눅스: /home/sceuick/.agnai/
맥: /Users/sceuick/.agnai
Windows: C:Userssceuick.agnai .

특징

• 그룹 대화 : 여러 봇을 사용하는 여러 사용자
• 다양한 AI 서비스 : Kobold, Novel, AI Horde, Goose, OpenAI, Claude, Replicate, OpenRouter, Mancer 지원
• 다양한 페르소나 스키마 형식: W++, 대괄호 형식(SBF), Boostyle, 일반 텍스트
• 다중 테넌시:
  • 사용자 인증
  • 사용자 설정: 사용할 AI 서비스와 자체 설정
  • 사용자 생성 사전 설정
• 구독
• 기억/지식 서적
• AI로 캐릭터 생성
• 타사 서비스를 사용한 이미지 생성
• 선택적 파이프라인 기능
  • 장기 기억
  • Wikipedia 기사 및 PDF 삽입

수동으로 실행

3. Node.js 설치
4. MongoDB 설치 선택사항
   • 데이터베이스는 선택 사항입니다. Agnaistic은 사용 가능한 데이터베이스가 없는 경우 anonymous-only 모드로 실행됩니다.
   • Anonymous 사용자의 데이터는 브라우저의 로컬 저장소에 저장됩니다. 귀하의 데이터는 "지속"되지만 장치나 다른 브라우저 간에 공유할 수는 없습니다. 브라우저의 애플리케이션 데이터/쿠키를 지우면 이 데이터가 삭제됩니다.
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
   • 로컬 터널을 사용하여 프로젝트를 빌드하고 실행합니다.
     • Mac/Linux: npm run start:public
     • Windows: npm run start:public:win

도커로 실행하기

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 이라는 파일을 생성하여 전체 애플리케이션에 일부 변경 사항을 적용할 수 있습니다.
귀하의 신청서에 특별한 요구 사항이 있는 경우, 이곳에서 해당 신청서를 요청하실 수 있습니다.

나는 이러한 요청을 수용하는 것과 코드베이스에서 통제를 벗어나지 않도록 하는 것 사이에서 균형을 찾으려고 노력할 것입니다.

이에 적합한 요청의 예:

• 모든 사용자에게 "기본 메모리 북"을 적용하고 싶습니다.
• 제공된 것과 다른 최종 토큰 세트를 사용하고 싶습니다.
• 익명 액세스를 비활성화하고 싶습니다

설정.json

사용 가능한 모든 설정의 예를 보려면 template.settings.json 을 복사하거나 살펴보세요. 변경 사항을 적용하려면 Agnai를 다시 시작해야 합니다.

현재 지원되는 사용자 정의 설정:

• baseEndTokens : 기본 세트에 추가 응답 종료 토큰을 추가합니다.

개발자용

권장 개발 도구

다음 확장과 함께 VSCode를 사용하는 것이 좋습니다.

• Prettier - Code formatter : 자동 서식 지정용
• Tailwind CSS Intellisense : Tailwind CSS 클래스를 사용한 자동 완성 및 Intellisense용
• Prettier를 사용하여 자동 형식을 지정하려면 VSCode settings.json 에 "editor.formatOnSave": true 추가하세요.

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

이 시점에서 UI를 보려면 브라우저에서 http://localhost:3001에 액세스할 수 있어야 합니다.

http://localhost:1234에서 핫 리로딩을 사용하여 프런트엔드에 액세스할 수도 있습니다.

권장 개발자 도구

• Redux 개발 도구
  • 프런트엔드 애플리케이션 상태는 "Redux Dev Tools" Chrome 확장 프로그램에 연결됩니다.
• NodeJS 디버거
  • pnpm start 스크립트는 --inspect 플래그를 사용하여 NodeJS API를 시작합니다.
  • VSCode의 기본 시작 작업을 사용하여 연결( F5 )
  • 또는 chrome://inspect URL로 이동하여 디버거를 사용하세요.
• Poetry 사용한 Python 종속성 관리 - 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으로 테스트되었습니다.