Narcooo/inkos

Story Creation AI Agent for novel, scripts, translation, interactive games, and IP content

InkOS – AI 기반 스토리 창작 에이전트

개요 – InkOS는 소설 및 관련 콘텐츠 작성을 위한 Node 기반 AI 에이전트 시스템입니다. 단일 작업 공간에서 장편 소설, 단편, 각본, 인터랙티브 "플레이" 세계, 다국어 번역을 만들 수 있습니다. 핵심 아이디어는 pi-agent 하네스입니다. 언어 모델(예: Moonshot Kimi, Claude, Gemini, DeepSeek 등)이 작업을 제안하면 InkOS가 이를 결정적으로 실행하여 컨텍스트, 상태, 파일 지속성을 관리합니다.

주요 기능

통합 워크벤치 – Studio(웹 UI), TUI(터미널 UI), CLI가 모두 동일한 액션 엔진을 공유합니다.
다중 장르 파이프라인 – 소설 작성, 단편 생성, 각본/씬 초안, 인터랙티브 영화/플레이 세계, 번역을 위한 내장 "스킬" 제공.
상태 인식 작성 – 스토리 전반 메모리(SQLite FTS5/BM25), 챕터 수준 스냅샷, 구조화된 JSON 상태 파일로 플롯 라인, 캐릭터 아크, 복선의 일관성을 유지합니다.
모델 무관 – kkaiapi 통합 레이어를 통해 Moonshot Kimi, Claude, Gemini, DeepSeek, OpenRouter, Ollama 등과 호환됩니다. 서로 다른 에이전트(작가, 감수자, 레이더)를 서로 다른 모델에 라우팅할 수 있습니다.
전문 워크플로우 – 계획 → 구성 → 작성 → 검토 → 원자적 커밋, 명시적 확인 대화상자와 감사 가능한 관찰 로그 제공.
표지 이미지 생성 – 선택적 이미지 서비스(gpt-image-2 또는 기타)가 프롬프트에서 책 표지를 생성합니다.
OpenClaw 스킬 – 호환 가능한 모든 에이전트에서 호출 가능(inkos interact --json --message \"…\").
내보내기 – 마크다운, EPUB 및 기타 형식 생성; 단편 번들에는 개요, 판매 패키지, 표지 자산이 포함됩니다.

설치

# Node 22.16+ 필요
npm i -g @actalk/inkos

clawhub install inkos로 OpenClaw 스킬을 설치할 수도 있습니다.

일반 워크플로우

책 만들기 – inkos book create --title \"My Epic\" --genre fantasy.
챕터 쓰기 – inkos write next My\ Epic (또는 Studio 채팅 UI 사용).
검토 및 수정 – inkos review My\ Epic은 관찰 결과를 표시하고, inkos revise My\ Epic 12 --instruction \"fix timeline\"은 대상 수정을 적용합니다.
표지 생성 – Studio에서 표지 서비스를 구성한 후 inkos cover generate \"My Epic\" 실행.
내보내기 – inkos export My\ Epic --format epub.

구성

Studio UI – 시각적 설정에서 공급자, 모델, API 키를 설정합니다. 비밀번호는 .inkos/secrets.json에 저장됩니다.
CLI / 환경 변수 – 전역 또는 프로젝트 수준 환경 변수(INKOS_LLM_PROVIDER, INKOS_LLM_BASE_URL, INKOS_LLM_API_KEY, INKOS_LLM_MODEL 등)가 Studio 설정을 덮어씁니다.
다중 모델 라우팅 – inkos config set-model writer <model> --provider <provider>로 서로 다른 에이전트가 서로 다른 모델을 사용할 수 있습니다.

확장성

사용자 정의 스킬 파일(skills/SKILL.md)을 추가하여 새로운 전문 방법(예: 탐정극 스킬)을 정의할 수 있습니다. 스킬은 정적 설명자이며, 에이전트가 호출 시점을 결정합니다.
SQLite 메모리 데이터베이스를 통해 추가 검색 소스를 연결할 수 있습니다.
장기 실행 작업에 대한 알림 채널(Telegram, Feishu, webhook)을 연결할 수 있습니다.

중요성 InkOS는 AI 지원 소설의 가장 큰痛点인 여러 챕터에 걸친 내러티브 일관성 유지를 해결합니다. 계획(구조화된 상태)과 생성(LLM 출력)을 분리하고 모든 것을 원자적으로 저장함으로써, 순진한 프롬프트 전용 접근 방식에서 흔한 "플롯 유실" 및 "캐릭터 불일치" 문제를 줄입니다.

결론 – InkOS는 웹 스튜디오, 터미널 UI, 명령줄 도구를 강력한 에이전트 기반 파이프라인과 결합한 풀스택 오픈소스 AI 저작 플랫폼으로, 대규모 스토리 창작, 인터랙티브 세계 구축, 다국어 번역을 더욱 통제 가능하고 재현 가능하게 만듭니다.

요점 – InkOS는 웹 스튜디오, 터미널 UI, 명령줄 도구를 강력한 에이전트 기반 파이프라인과 결합한 풀스택 오픈소스 AI 저작 플랫폼으로, 대규모 스토리 창작, 인터랙티브 세계 구축, 다국어 번역을 더욱 통제 가능하고 재현 가능하게 만듭니다.