Narcooo/inkos
InkOS 2.0, 소설·각본·인터랙티브 창작 에이전트
원제 Narcooo/inkos
스타 10,841당일 +107TypeScript
Key Point
장편 소설의 설정·복선 일관성 문제를 상태 검증과 원자적 저장으로 다루는 창작 에이전트 구조를 볼 수 있다.
핵심 요약
- InkOS는 장편·단편 소설, 각본, 스토리보드, 인터랙티브 게임, IP 콘텐츠, 다국어 번역을 한 작업대에서 다루는 스토리 창작 AI 에이전트 시스템이며 Studio, TUI, CLI 인터페이스를 지원한다.
- v2.0.0은 pi-agent 기반의 단일 프로덕션 하니스로 통합됐다. 모델은 이해와 제안, 호출을 맡고 InkOS는 확인, 컨텍스트, 상태, 원자적 저장을 맡는다.
- 1.x 프로젝트는 `inkos work migrate --json`으로 점검하고 `--apply`로 통합 창작 라이브러리에 가져온다. 원본 디렉터리와 백업은 유지되며 충돌 시 기존 작품을 덮어쓰지 않는다.
- 장편은 창작 브리프로 세계관·캐릭터·권 개요를 만들고 '계획→구성→집필→검토→커밋' 순서로 쓴다. 검토는 증거 기반 observation만 남기며 챕터를 실패 처리하지 않는다.
- 장편 집필 전 현재 정사를 바탕으로 2~5개의 독립된 미래 분기를 만들어 비교할 수 있다. 분기를 선택해도 후보 계획만 저장되고 본문과 정사는 바뀌지 않는다.
- InkOS Short는 완결 단편 본문, 개요, 검토 기록, 소개 문구, 표지 프롬프트와 표지 이미지를 생성한다. InkOS Play는 자연어로 세계 규칙을 정의하는 오픈월드·분기형 인터랙션을 제공한다.
- 내장 전문 Skill 19종이 표준 SKILL.md로 제공되며 프로젝트나 사용자 디렉터리의 같은 ID 스킬로 덮어쓸 수 있다. 외부 Skill은 지침만 제공하고 스크립트를 실행하거나 권한을 넓히지 않는다.
- 기억은 Zod로 검증하는 JSON 상태가 권위 원본이고, Markdown은 읽기용 투영, SQLite FTS5/BM25 인덱스는 재생성 가능한 검색용이다. 글자 수는 목표 범위만 관리하며 본문을 자르지 않는다.
- LLM 설정은 Studio의 서비스 설정과 CLI·데몬의 env 설정으로 분리된다. Gemini, Moonshot, DeepSeek, OpenRouter, kkaiapi, Ollama 등 여러 서비스와 3가지 API 프로토콜을 지원하며 에이전트별 모델 라우팅도 가능하다.
- 그 밖에 문체 모방, 기존 원고 가져오기, 팬픽 4가지 모드, 데몬과 알림(Telegram·Feishu 등) 기능이 있다. Node.js 22.16 이상이 필요하고 라이선스는 AGPL-3.0이다.
- 로드맵에는 반 챕터 단위 부분 개입, 커스텀 에이전트 플러그인, 플랫폼 형식 내보내기가 남아 있다.
저장소 보기 ↗github.com