긴 원고를 읽고 다음 장면을 이어 쓰는 개인용 창작 웹앱이에요. 봇별로 채팅·폴더를 관리하고 Risu 원본 봇·페르소나·모듈을 사용할 수 있어요. 프롬프트와 모델은 따로 설정하며, 원문·번역을 직접 편집하거나 채팅을 독립 사본으로 복사할 수 있어요. 이야기 기억과 백업 기능도 제공해요.
이 소스의 앱 버전은 **v0.12.5**예요. 자료 생성·복제 요청의 응답이 유실돼도 중복 생성 없이 이전 요청을 확인하고, 사본 저장 실패 시 편집 충돌과 미저장 입력을 유지해요. DB 스키마는 15로 유지해요. 자세한 변경은 릴리스 노트, 설치 절차는 업데이트 안내를 참고해요.
개인 ChatGPT 구독으로 에이전트를 실행하려면 Codex 연결 안내를 따라 서버 실행기를 준비하고 설정 → Codex 연결에서 로그인해요.
Node 24.22.1 이상 24.x, npm, Chrome 또는 Edge가 필요해요. SQLite는 Node에 포함된 기능을 사용해요.
태그 기반 설치는 v0.12.5를 사용해요. 설치 전에 GitHub Releases에서 해당 릴리스가 공개됐는지 확인해요.
git clone --branch v0.12.5 --single-branch https://github.com/woduseh/Uimori.git
cd Uimori
npm ci
npm run dev이미 소스를 받았다면 프로젝트 루트에서 npm ci부터 실행해요. 실행 후 로컬 앱을 열어요. dev는 빌드 후 서버를 시작하며, 이미 빌드했다면 npm start로 실행할 수 있어요. 이전 서버를 사용 중이면 해당 터미널에서 Ctrl+C로 종료한 뒤 다시 시작해요.
- 서재 → 봇에서 자료를 만들거나 고른 뒤 봇으로 새 채팅, 또는 왼쪽 탐색에서 봇을 고르고 새 채팅을 눌러요. 봇은 필수이고, 만든 채팅의 소속 봇은 바꾸지 않아요. 페르소나·프롬프트·창작 프리셋은 선택할 수 있어요.
- 설정 → 프로바이더와 모델에서 프로바이더와 모델을 등록하고 전역 역할별 모델로 선택해요. 모델 없이 채팅을 만들거나 작성된 시작문을 사용할 수 있지만, 본문 생성·번역 등 모델을 실행하는 역할에는 모델 선택이 필요해요. 프로바이더 추가에서 TypeSafe AI를 선택하면 JEV가 모델 목록에 등록돼요. 본문·번역 거절 판정과 로어 관련성은 JEV가 담당하고, 기존 이미지 배치는 작문 모델 또는 JEV를 선택해요. JEV를 사용하는 기능만 키 등록이 필요하며 본문 거절 감지는 기본으로 꺼져 있어요. API 키는 앱에서 바로 입력해요.
- 하단 입력창에 장면 요청을 보내요. 기본 전송 키는 Ctrl/Cmd+Enter예요.
- 원고의 번역 생성을 누르면 번역을 시작해요. 저장된 번역은 번역 보기로 열고, 실패한 번역은 번역 다시 시도로 요청해요. 저장된 번역의 보기 전환과 원문·번역 직접 저장은 모델을 호출하지 않아요.
Self-host 안내에 Docker Compose와 Nginx HTTPS 구성이 있어요. 도메인·인증서·접속 토큰을 설정하면 PC와 휴대폰에서 같은 작업실에 접속할 수 있어요. SQLite는 영구 volume에 저장해요. 지원하는 수동 업데이트 절차는 업데이트 안내를 확인해요.
설정 → 앱 정보에서 현재 서버의 앱 버전과 빌드 식별자를 확인해요. 앱 버전은 릴리스 번호이며 DB 스키마 번호와 별개예요. 업데이트 알림·앱 내 설치·무인 자동 업데이트는 제공하지 않아요. 기존 설치는 수동 업데이트를 따르고, 운영 중인 Oracle 설치는 전용 배포 안내를 사용해요. 태그나 GitHub Release를 만드는 것만으로 서버가 업데이트되지는 않아요.
설정 → 일반 → 화면 언어에서 한국어·영어·일본어·중국어(간체)를 선택해요. 선택은 브라우저에 유지되며 원고·저장 번역과 생성·번역 대상 언어는 그대로예요. 언어 설정과 적용 범위를 참고해요.
| 문서 | 내용 |
|---|---|
| 사용 안내 | 봇별 채팅·폴더, 설정 검색, 프롬프트·창작 프리셋, 번역·독립 채팅 복사, 백업 |
| 구성·집필 작업실 | 계층형 구성, 관련 계획 연결, 선택한 단위 집필과 원문 점검 |
| 원작 참고 | 선택형 집필 참고문, 도우미를 통한 원작 질문, 메모·정정 |
| 도우미 도구 · Codex 연결 | 부분 조회·편집, 설정·작업 제어와 네이티브 실행 |
| 서재와 프롬프트 · 항목 삭제 | 자료 분류·폴더·대표 이미지, 삭제 위치와 참조 보호 |
| Risu 원본 가져오기 | .charx 카드·모듈·.risup 프롬프트 원본, CBS·Lua·정규식·CSS 실행과 지원 범위 |
| Risu 자료 내보내기 | 저장한 카드·모듈·프롬프트를 CHARX·RISUM·RISUP으로 내보내기 |
| 앱 설치·완료 알림 | PWA 설치, 원고 캐시 없는 서비스 워커, 명시적 기기별 Web Push |
| 작업실 사용량 | 일별·모델별·용도별 호출·토큰·보고/추정 비용 |
| 읽기 위치·책갈피 | 기기별 이어 읽기, 책갈피와 개인 백업 |
| 원고 검색 | 원문·번역·요청의 본문 검색과 장면 이동 |
| 자동 백업 | 한국 시간 일일 스냅샷, 검증·보관·다운로드 |
| 문제 확인과 실행 상세 | 작업 상태·오류·남아 있는 실행 입력과 복구 동작 확인 |
| 장면 삽화 | Codex 이미지 생성·원격 ComfyUI로 응답별 삽화 생성, 자동 생성·재요청·개수 한도 |
| 프로바이더 | Vertex·Google AI Studio Gemini, Responses·Chat 호환, Anthropic 실시간·Batch, Vercel, Codex 프로바이더와 선택형 평가 도구·합성 시험 |
| 개발과 검증 | 검사·정리 명령, 격리 실행, 코드 구조와 증거 보관 |
| 개인 서버 배포 | Docker Compose, HTTPS, 로그인, 영구 데이터, 모델 API 키와 업데이트 |
| Oracle 릴리스 | 검증·배포 명령, 데이터 보존과 실패 복구 |
| 코드 지도 | 기능별 현행 문서와 구현 진입점 |
- 기본 DB는
.local/uimori.sqlite예요. 빈 DB와 현재 데이터 형식만 열며 구형 DB는 변경 없이 거절해요. 옛 백업은 당시 앱 버전과 함께 보관해요. 테스트용 개발 DB를 초기화하려면 서버 종료 후npm run reset:dev를 실행해요. - 설정 → 데이터 관리 → 내보내기와 복원에서 SQLite 백업을 저장해요. 개별 자료와 채팅은 새 사본으로 가져올 수 있어요. 백업·격리 DB 사용법
- 기본은
127.0.0.1로컬 모드이며UIMORI_ACCESS_TOKEN인증을 선택할 수 있어요. 개인 서버 모드는UIMORI_PUBLIC_ORIGIN에 HTTPS 주소 하나를 지정하고 32자 이상 접속 토큰을 필수로 사용해요.UIMORI_HOST로 수신 주소를 정하며 외부 수신은 개인 서버 모드에서만 허용해요. 접속 조건 - 프로바이더 API 키와 JEV 키는 앱에서 입력하고 DB에 저장해요. 전체 SQLite 백업에는 키와 이미지가 포함돼요. 사용자 DB와 실행 산출물은 Git에서 제외해요.
Uimori 프로젝트 소스는 AGPL-3.0-only로 제공해요. RPack을 포함한 제3자 구성 요소의 원본 조건·저작권은 제3자 고지를 확인해요. 사용자 자료·채팅·생성 결과의 권리는 각자의 이용 조건에 따르며 앱 소스 라이선스가 자동 적용되지 않아요. 서버로 제공하거나 수정본을 배포할 때는 실행 빌드에 맞는 대응 소스 제공 안내를 따라요.