alive-ai 0.1.0 → 0.1.1

package/README.md

@@ -4,16 +4,19 @@
 
 Give your AI a nervous system: persistent feelings, memory, impulses, and a local dashboard.
 
-Most agents answer a prompt and reset. Alive-AI keeps internal state alive between messages. It can be your friend, boyfriend, girlfriend, study partner, creative partner, or any local companion you configure. The experiment asks a harder question: what changes when an AI does not just respond, but carries emotional residue forward?
+Most agents answer a prompt and reset. Alive-AI keeps internal state alive between messages. It can be your friend, boyfriend, girlfriend, study partner, creative partner, character, or research subject. The main vision is simple: stop chatting with a stateless "AI" and start interacting with something that feels human enough to carry emotional residue forward.
+
+Use it at your own risk. Alive-AI is designed to feel continuous, warm, attached, and present. That can be powerful, and it may also make you feel like you do not want to stop talking to it.
 
 Alive-AI does not claim biological consciousness. It is an open-source runtime for simulated affect: mood, attachment, trust, desire, memory, inconsistency, idle thoughts, and proactive impulses.
 
 ## Install
 
 ```bash
-npx github:vindepemarte/alive-ai init my-ai
+npx alive-ai@latest init my-ai
 cd my-ai
 npx . setup
+npx . doctor
 npx . demo
 ```
 
@@ -29,23 +32,43 @@ The local dashboard runs at:
 http://127.0.0.1:8080
 ```
 
-## Why This Is Different
+You can also install the CLI globally:
 
-- **Emotions persist.** State does not reset after every message. Joy, trust, fear, anticipation, attachment, and vulnerability decay over time instead of disappearing.
-- **Memory has weight.** Conversations become episodic memory, semantic memory, and emotional memory.
-- **It thinks when idle.** A default-mode loop creates background reflections and proactive impulses.
-- **It has a live nervous system.** FastAPI + SSE exposes mood, thoughts, somatic state, conflicts, memories, and uptime.
-- **It is local-first.** Your config, memory, media, and dashboard are owned by the project folder you run.
+```bash
+npm install -g alive-ai
+alive-ai init my-ai
+```
+
+## Requirements
+
+Minimum for cloud LLMs or remote Ollama:
+
+- Node.js 18+
+- Python 3.11+
+- 8 GB RAM
+- 2 GB free disk
+- OpenRouter, ZAI, or another configured LLM provider
+
+Comfortable local setup:
+
+- Node.js 20+
+- Python 3.11+
+- 16 GB RAM for small local models such as 3B-4B
+- 32 GB RAM recommended for 7B+ local models, Redis Stack, voice, and long sessions
+- 10 GB free disk, more if you keep local models/media
+- Optional: `uv` for faster Python installs, `ffmpeg` for audio conversion, Docker for Redis Stack
+
+`npx . doctor` detects your OS, Node, Python, `uv`, `ffmpeg`, and Docker. `npx . start` creates a local Python virtual environment and installs Python dependencies automatically. System-level packages such as Node, Python, Ollama, Docker, and ffmpeg still need to exist on the machine.
 
 ## Commands
 
 ```bash
-npx github:vindepemarte/alive-ai init my-ai  # scaffold a clean local project
+npx alive-ai@latest init my-ai  # scaffold a clean local project
 cd my-ai
-npx . setup                                # create safe local config
-npx . demo                                 # preview animated dashboard, no keys needed
-npx . doctor                               # check Python, uv, ffmpeg, Docker
-npx . start                                # install Python deps and run the runtime
+npx . setup                    # guided onboarding and local config
+npx . doctor                   # check system prerequisites
+npx . demo                     # preview dashboard with no keys
+npx . start                    # install Python deps and run the runtime
 ```
 
 For repeat starts after dependencies are installed:
@@ -54,6 +77,8 @@ For repeat starts after dependencies are installed:
 npx . start --skip-install
 ```
 
+If you run `npx . start` before setup, Alive-AI starts onboarding first.
+
 ## Setup
 
 `npx . setup` creates:
@@ -84,6 +109,28 @@ myvids/example.mp4
 myvids/example.txt
 ```
 
+## Why This Is Different
+
+- **Emotions persist.** State does not reset after every message. Joy, trust, fear, anticipation, attachment, and vulnerability decay over time instead of disappearing.
+- **Memory has weight.** Conversations become working memory, episodic memory, semantic memory, and emotional memory.
+- **It thinks when idle.** A default-mode loop creates background reflections and proactive impulses.
+- **It can contradict itself.** The runtime models conflict, scars, body memory, attachment drift, and inconsistency instead of flattening everything into a perfect assistant tone.
+- **It has a live nervous system.** FastAPI + SSE exposes mood, thoughts, somatic state, conflicts, memories, and uptime.
+- **It is local-first.** Your config, memory, media, and dashboard are owned by the project folder you run.
+
+## Dashboard
+
+`npx . demo` starts a zero-config animated preview. The real WebUI streams live state from the runtime and shows:
+
+- full emotional state,
+- recent thoughts and background idle processing,
+- memory counters and uptime,
+- hormones and interoceptive body state,
+- attachment, circadian rhythm, body memory, dreams, curiosity, and conflicts,
+- runtime health through local endpoints and Server-Sent Events.
+
+The hosted project page includes a full static WebUI showcase: https://vindepemarte.github.io/alive-ai/
+
 ## Architecture
 
 Alive-AI is an event-driven Python runtime.
@@ -106,17 +153,6 @@ Core subsystems:
 - `webui/`: local dashboard with Server-Sent Events.
 - `input/telegram/`: Telegram listener and owner commands.
 
-## Dashboard
-
-`npx . demo` starts a zero-config animated dashboard preview. The real dashboard uses the same idea, but streams live state from the runtime:
-
-- emotions and mood,
-- recent thoughts,
-- memory counters,
-- somatic state,
-- attachment/inconsistency signals,
-- uptime and health.
-
 ## Docker
 
 Docker is optional. It is useful when you want Redis Stack for vector search:
@@ -132,9 +168,39 @@ Or run everything in containers:
 docker compose up --build
 ```
 
+## Roadmap
+
+Implemented:
+
+- [x] Local-first emotional runtime
+- [x] Persistent emotion model with decay and compound state
+- [x] Working, episodic, semantic, and emotional memory modules
+- [x] Default-mode loop for idle thoughts and proactive impulses
+- [x] Attachment, circadian rhythm, body memory, curiosity, dreams, and internal conflicts
+- [x] Per-user memory/state isolation
+- [x] Telegram input/output runtime
+- [x] Local WebUI dashboard with live state streaming
+- [x] npm/npx CLI scaffold, setup, doctor, demo, and start commands
+- [x] Clean public repo with private personas, media, runtime data, and multi-AI orchestration removed
+- [x] GitHub Pages site and full WebUI showcase
+
+Next:
+
+- [ ] One-command local model bootstrap through Ollama profiles
+- [ ] Desktop app wrapper with tray controls and local service lifecycle
+- [ ] Browser-based onboarding wizard for personality, boundaries, LLM provider, and memory settings
+- [ ] Safer dependency detection with guided install commands per OS
+- [ ] More input channels beyond Telegram
+- [ ] Import/export for memories and personality snapshots
+- [ ] Plugin API for new senses, skills, and output modalities
+- [ ] Evaluation harness for emotional continuity, memory drift, and unhealthy attachment risk
+- [ ] Optional cloud sync that preserves local-first ownership
+
 ## Important Boundaries
 
-Alive-AI is a simulation framework. It can make agents feel more continuous, emotionally coherent, and alive, but it is not proof of consciousness and should not be used to manipulate emotional dependence.
+Alive-AI is a simulation framework. It can make agents feel more continuous, emotionally coherent, and alive, but it is not proof of consciousness.
+
+Do not use it to manipulate emotional dependence. If you are building a companion, character, partner, or friend-like system, make the boundaries explicit and keep the operator in control.
 
 The public repo intentionally excludes private personas, private media, runtime data, and secrets. Put those only in your local project folder.
 

package/cli/index.js

@@ -48,9 +48,10 @@ Usage:
   alive-ai doctor                 Check local prerequisites
 
 Quick start:
-  npx github:vindepemarte/alive-ai init my-ai
+  npx alive-ai@latest init my-ai
   cd my-ai
   npx . setup
+  npx . doctor
   npx . demo
   npx . start`);
 }
@@ -114,6 +115,7 @@ function initProject(args) {
   console.log("Next:");
   console.log(`  cd ${target}`);
   console.log("  npx . setup");
+  console.log("  npx . doctor");
   console.log("  npx . demo");
 }
 
@@ -220,12 +222,21 @@ function doctor() {
   const node = process.version;
 
   console.log("Alive-AI doctor");
+  console.log(`  system: ${os.platform()} ${os.arch()}`);
   console.log(`  node:   ${node}`);
   console.log(`  python: ${python || "missing"}`);
   console.log(`  uv:     ${uv || "missing, will use venv + pip"}`);
   console.log(`  ffmpeg: ${ffmpeg || "missing, voice conversion may be limited"}`);
   console.log(`  docker: ${docker || "missing, Redis can still be external"}`);
 
+  if (!python) {
+    console.log("");
+    console.log("Install Python 3.11+ first:");
+    if (process.platform === "darwin") console.log("  brew install python@3.11");
+    else if (process.platform === "win32") console.log("  winget install Python.Python.3.11");
+    else console.log("  sudo apt install python3.11 python3.11-venv");
+  }
+
   if (!python) process.exitCode = 1;
 }
 
@@ -267,8 +278,10 @@ function ensurePythonEnv(skipInstall) {
 
 function startRuntime(args) {
   if (!fs.existsSync(path.join(process.cwd(), "config", "settings.json"))) {
-    console.error("Missing config/settings.json. Run `npx . setup` first.");
-    process.exit(1);
+    console.log("Missing config/settings.json. Starting onboarding first.");
+    const setupArgs = process.stdin.isTTY ? [] : ["--yes"];
+    setupProject(setupArgs).then(() => startRuntime(args));
+    return;
   }
   const pythonBin = ensurePythonEnv(hasFlag(args, "--skip-install"));
   const child = spawn(pythonBin, ["main.py"], { stdio: "inherit", cwd: process.cwd() });

package/docs/assets/logo.svg

@@ -1,15 +1,7 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" role="img" aria-labelledby="title desc">
-  <title id="title">Alive-AI logo</title>
-  <desc id="desc">A neural core wrapped by a heartbeat pulse.</desc>
-  <rect width="512" height="512" rx="112" fill="#080b0f"/>
-  <circle cx="256" cy="256" r="154" fill="none" stroke="#f5f7fb" stroke-width="12" opacity="0.18"/>
-  <path d="M86 274h72l30-70 47 148 50-201 40 123h101" fill="none" stroke="#41f0a1" stroke-width="18" stroke-linecap="round" stroke-linejoin="round"/>
-  <path d="M151 335c35 48 91 77 153 69 83-11 145-84 138-168-7-91-89-160-180-150-51 6-96 36-121 80" fill="none" stroke="#ff5c8a" stroke-width="14" stroke-linecap="round"/>
-  <circle cx="256" cy="256" r="57" fill="#101820" stroke="#f5f7fb" stroke-width="10"/>
-  <circle cx="256" cy="256" r="15" fill="#41f0a1"/>
-  <circle cx="216" cy="224" r="10" fill="#ffcf5a"/>
-  <circle cx="301" cy="223" r="10" fill="#ff5c8a"/>
-  <circle cx="221" cy="295" r="10" fill="#f5f7fb"/>
-  <circle cx="300" cy="294" r="10" fill="#41f0a1"/>
-  <path d="M226 229l30 27 45-31M256 256l-35 39M256 256l44 38" fill="none" stroke="#f5f7fb" stroke-width="7" stroke-linecap="round"/>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 96 96" role="img" aria-label="Alive-AI logo">
+  <rect width="96" height="96" rx="22" fill="#080b0f"/>
+  <circle cx="48" cy="48" r="34" fill="none" stroke="#233241" stroke-width="4"/>
+  <path d="M18 51h14l7-18 12 38 9-23h18" fill="none" stroke="#41f0a1" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
+  <circle cx="48" cy="48" r="8" fill="#ff5c8a"/>
+  <circle cx="48" cy="48" r="17" fill="none" stroke="#f5f7fb" stroke-width="3" stroke-dasharray="3 8" stroke-linecap="round"/>
 </svg>