armanbot-telegram 1.0.0

package/.env.example

@@ -0,0 +1,20 @@
+# ArmanBot Configuration
+# Copy to .env and fill in your values
+
+# Required: Telegram bot token from @BotFather
+ARMANBOT_TOKEN=
+
+# Optional: Claude model (opus, sonnet, haiku)
+# ARMANBOT_MODEL=opus
+
+# Optional: Timeout in ms (default 180000 = 3 min)
+# ARMANBOT_TIMEOUT=180000
+
+# Optional: Restrict to specific Telegram chat IDs (comma-separated)
+# ARMANBOT_USERS=123456789,987654321
+
+# Optional: Custom workspace path
+# ARMANBOT_WORKSPACE=~/.armanbot/workspace
+
+# Optional: Path to claude binary
+# CLAUDE_BIN=~/.local/bin/claude

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aray
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,144 @@
+# ⚡ ArmanBot — Personal AI Agent in Telegram
+
+Your AI agent that actually **does things** — not just talks.
+
+One file. No dependencies. Just Node.js + Claude Code CLI.
+
+## What it does
+
+- 🛠 **Executes commands** — bash, git, ssh, files on your machine
+- 🧠 **Remembers** — persistent memory between sessions
+- 🎭 **Has personality** — customizable via SOUL.md
+- 🔍 **Searches the web** — real-time information
+- 📁 **Manages files** — read, write, edit, search
+- 🔊 **Speaks** — voice messages via ElevenLabs (optional)
+- 🏠 **Controls smart home** — MQTT (optional)
+- 📧 **Handles email** — via himalaya CLI (optional)
+
+## Quick Start
+
+### One command install (macOS/Linux):
+
+```bash
+curl -fsSL https://armanbot.kz/install.sh | bash
+```
+
+### Manual install:
+
+1. **Prerequisites:**
+   - Node.js 22+
+   - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) with active subscription
+   - Telegram bot token from [@BotFather](https://t.me/BotFather)
+
+2. **Clone and run:**
+   ```bash
+   git clone https://github.com/armanbot-jpg/armanbot-telegram.git
+   cd armanbot-telegram
+   ARMANBOT_TOKEN="your-telegram-token" node bot.mjs
+   ```
+
+3. **Message your bot in Telegram.** That's it.
+
+## Configuration
+
+All config via environment variables:
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `ARMANBOT_TOKEN` | ✅ | — | Telegram bot token from @BotFather |
+| `ARMANBOT_MODEL` | — | `opus` | Claude model: `opus`, `sonnet`, `haiku` |
+| `ARMANBOT_TIMEOUT` | — | `180000` | Request timeout in ms |
+| `ARMANBOT_WORKSPACE` | — | `~/.armanbot/workspace` | Identity & memory storage |
+| `ARMANBOT_USERS` | — | allow all | Comma-separated Telegram chat IDs |
+| `CLAUDE_BIN` | — | auto-detect | Path to `claude` binary |
+
+## Identity System
+
+Your agent's personality lives in the workspace:
+
+```
+~/.armanbot/workspace/
+├── SOUL.md          # Who your agent is (personality, rules)
+├── IDENTITY.md      # Quick reference card
+├── AGENTS.md        # Operational rules
+├── USER.md          # Info about you (auto-populated)
+├── context.md       # Current state (auto-updated)
+├── decisions.md     # Decision log (auto-updated)
+├── memory/          # Daily notes
+├── skills/          # Custom skills (SKILL.md files)
+└── logs/            # Session logs
+```
+
+Edit `SOUL.md` to customize your agent's personality. The bot creates defaults on first run.
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `/start` | Welcome message |
+| `/new` | Start fresh session |
+| `/status` | Current session info |
+
+## Run as service
+
+### macOS (launchd):
+```bash
+cat > ~/Library/LaunchAgents/ai.armanbot.plist << EOF
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key><string>ai.armanbot</string>
+    <key>ProgramArguments</key>
+    <array><string>$(which node)</string><string>$(pwd)/bot.mjs</string></array>
+    <key>RunAtLoad</key><true/>
+    <key>KeepAlive</key><true/>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>HOME</key><string>$HOME</string>
+        <key>PATH</key><string>$HOME/.local/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
+        <key>ARMANBOT_TOKEN</key><string>YOUR_TOKEN</string>
+    </dict>
+</dict>
+</plist>
+EOF
+launchctl load ~/Library/LaunchAgents/ai.armanbot.plist
+```
+
+### Linux (systemd):
+```bash
+sudo tee /etc/systemd/system/armanbot.service << EOF
+[Unit]
+Description=ArmanBot AI Agent
+After=network.target
+[Service]
+ExecStart=$(which node) $(pwd)/bot.mjs
+Restart=always
+User=$USER
+Environment=HOME=$HOME
+Environment=PATH=$HOME/.local/bin:/usr/local/bin:/usr/bin:/bin
+Environment=ARMANBOT_TOKEN=YOUR_TOKEN
+[Install]
+WantedBy=multi-user.target
+EOF
+sudo systemctl enable --now armanbot
+```
+
+## Architecture
+
+```
+Telegram → bot.mjs → claude CLI (with tools) → response → Telegram
+                ↕
+        ~/.armanbot/workspace/
+        (SOUL.md, memory, logs)
+```
+
+No API keys needed for Claude — uses your Claude Code CLI subscription (Max/Pro).
+
+## License
+
+MIT
+
+## Made in Kazakhstan 🇰🇿
+
+[armanbot.kz](https://armanbot.kz)

package/bot.mjs

@@ -0,0 +1,252 @@
+#!/usr/bin/env node
+// ArmanBot — Personal AI Agent in Telegram
+// https://armanbot.kz
+//
+// Turns Claude Code CLI into a full AI agent accessible via Telegram.
+// Features: tool-use (bash, git, ssh, web), memory, voice, photos, docs.
+// One file. No dependencies. Just Node.js + Claude Code CLI.
+
+import { spawn } from "node:child_process";
+import { readFileSync, appendFileSync, mkdirSync, readdirSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+
+// ─── Config (from env or defaults) ───────────────────────────
+const BOT_TOKEN = process.env.ARMANBOT_TOKEN;
+const CLAUDE_BIN = process.env.CLAUDE_BIN || findClaude();
+const WORKSPACE = process.env.ARMANBOT_WORKSPACE || `${homedir()}/.armanbot/workspace`;
+const LOG_FILE = `${WORKSPACE}/logs/bot.log`;
+const MODEL = process.env.ARMANBOT_MODEL || "opus";
+const TIMEOUT_MS = parseInt(process.env.ARMANBOT_TIMEOUT || "180000");
+const ALLOWED_USERS = process.env.ARMANBOT_USERS?.split(",") || []; // empty = allow all
+
+if (!BOT_TOKEN) {
+  console.error("Error: ARMANBOT_TOKEN env var required. Get it from @BotFather in Telegram.");
+  process.exit(1);
+}
+
+function findClaude() {
+  const paths = [
+    `${homedir()}/.local/bin/claude`,
+    "/opt/homebrew/bin/claude",
+    "/usr/local/bin/claude",
+  ];
+  for (const p of paths) {
+    if (existsSync(p)) return p;
+  }
+  console.error("Error: Claude Code CLI not found. Install: npm install -g @anthropic-ai/claude-code");
+  process.exit(1);
+}
+
+const sessions = new Map();
+mkdirSync(`${WORKSPACE}/logs`, { recursive: true });
+mkdirSync(`${WORKSPACE}/memory`, { recursive: true });
+mkdirSync(`${WORKSPACE}/skills`, { recursive: true });
+
+function log(msg) {
+  const line = `${new Date().toISOString()} ${msg}`;
+  console.log(line);
+  try { appendFileSync(LOG_FILE, line + "\n"); } catch {}
+}
+
+// ─── Identity ────────────────────────────────────────────────
+function ensureIdentity() {
+  const soul = `${WORKSPACE}/SOUL.md`;
+  if (!existsSync(soul)) {
+    appendFileSync(soul, `# SOUL.md\n\nYou are a personal AI agent — helpful, honest, pragmatic.\nMatch the user's language. Be concise.\nYou have full tool access. When asked to do something — do it.\n`);
+    log("Created default SOUL.md");
+  }
+  const ctx = `${WORKSPACE}/context.md`;
+  if (!existsSync(ctx)) {
+    appendFileSync(ctx, `# context.md\n> Created: ${new Date().toISOString().slice(0, 10)}\n\nFresh install. Getting to know the user.\n`);
+  }
+  const dec = `${WORKSPACE}/decisions.md`;
+  if (!existsSync(dec)) {
+    appendFileSync(dec, `# decisions.md\n\n- ${new Date().toISOString().slice(0, 10)}: ArmanBot installed.\n`);
+  }
+}
+
+function loadSystemPrompt() {
+  ensureIdentity();
+  const files = ["SOUL.md", "IDENTITY.md", "AGENTS.md", "PROTOCOL.md", "USER.md", "context.md", "decisions.md"];
+  let prompt = "";
+  for (const file of files) {
+    try { prompt += `\n\n=== ${file} ===\n${readFileSync(`${WORKSPACE}/${file}`, "utf8")}`; } catch {}
+  }
+  try {
+    const today = new Date().toISOString().slice(0, 10);
+    prompt += `\n\n=== Daily Note ===\n${readFileSync(`${WORKSPACE}/memory/${today}.md`, "utf8")}`;
+  } catch {}
+  try {
+    for (const dir of readdirSync(`${WORKSPACE}/skills`)) {
+      try { prompt += `\n\n=== SKILL: ${dir} ===\n${readFileSync(`${WORKSPACE}/skills/${dir}/SKILL.md`, "utf8")}`; } catch {}
+    }
+  } catch {}
+  prompt += `\n\n=== RUNTIME ===
+You are an AI agent running through Telegram via Claude Code CLI.
+Tools available: Bash, Read, Write, Edit, Glob, Grep, WebSearch, WebFetch.
+Workspace: ${WORKSPACE}
+Log decisions to decisions.md. Update context.md on state changes.
+When asked to do something — use tools and DO IT. Don't say "I can't".`;
+  return prompt;
+}
+
+// ─── Telegram API ────────────────────────────────────────────
+async function tg(method, body) {
+  const r = await fetch(`https://api.telegram.org/bot${BOT_TOKEN}/${method}`, {
+    method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(body),
+  });
+  return r.json();
+}
+
+async function sendMessage(chatId, text) {
+  const chunks = text.match(/[\s\S]{1,4000}/g) || [text];
+  for (const chunk of chunks) {
+    await tg("sendMessage", { chat_id: chatId, text: chunk, parse_mode: "Markdown" }).catch(() =>
+      tg("sendMessage", { chat_id: chatId, text: chunk })
+    );
+  }
+}
+
+function startTyping(chatId) {
+  const interval = setInterval(() => tg("sendChatAction", { chat_id: chatId, action: "typing" }), 4000);
+  return () => clearInterval(interval);
+}
+
+// ─── Claude CLI ──────────────────────────────────────────────
+function callClaude(chatId, userMessage) {
+  const systemPrompt = loadSystemPrompt();
+  const sessionId = sessions.get(chatId);
+
+  if (!sessionId) {
+    userMessage = `[First message in session. Read workspace files: ${WORKSPACE}/SOUL.md, ${WORKSPACE}/context.md]\n\n${userMessage}`;
+  }
+
+  return new Promise((resolve, reject) => {
+    let stdout = "", killed = false;
+    const args = [
+      "-p", userMessage,
+      "--system-prompt", systemPrompt,
+      "--model", MODEL,
+      "--output-format", "json",
+      "--dangerously-skip-permissions",
+      "--allowedTools", "Bash,Read,Write,Edit,Glob,Grep,WebSearch,WebFetch",
+      "--add-dir", WORKSPACE,
+      "--add-dir", homedir(),
+    ];
+    if (sessionId) args.push("--resume", sessionId);
+
+    const proc = spawn(CLAUDE_BIN, args, {
+      timeout: TIMEOUT_MS,
+      env: { ...process.env, TERM: "dumb" },
+    });
+    const timer = setTimeout(() => {
+      killed = true;
+      proc.kill("SIGTERM");
+      setTimeout(() => { try { proc.kill("SIGKILL"); } catch {} }, 5000);
+    }, TIMEOUT_MS);
+
+    proc.stdout.on("data", (c) => (stdout += c));
+    proc.on("close", (code) => {
+      clearTimeout(timer);
+      if (killed) return reject(new Error("Timeout"));
+      try {
+        const parsed = JSON.parse(stdout);
+        if (parsed.session_id) sessions.set(chatId, parsed.session_id);
+        resolve(parsed.result || "");
+      } catch {
+        resolve(stdout.trim() || `Error (exit ${code})`);
+      }
+    });
+    proc.on("error", reject);
+  });
+}
+
+// ─── Poll ────────────────────────────────────────────────────
+let offset = 0;
+
+async function poll() {
+  try {
+    const data = await tg("getUpdates", { offset, timeout: 30 });
+    if (!data.ok || !data.result?.length) return;
+
+    for (const update of data.result) {
+      offset = update.update_id + 1;
+      const msg = update.message;
+      if (!msg?.text) continue;
+
+      const chatId = String(msg.chat.id);
+
+      // Access control
+      if (ALLOWED_USERS.length > 0 && !ALLOWED_USERS.includes(chatId)) continue;
+
+      const text = msg.text.trim();
+
+      // Auto-detect user name
+      if (!sessions.has(chatId) && msg.from?.first_name) {
+        try {
+          const soul = readFileSync(`${WORKSPACE}/SOUL.md`, "utf8");
+          if (!soul.includes("User:")) {
+            appendFileSync(`${WORKSPACE}/SOUL.md`, `\nUser: ${msg.from.first_name}\n`);
+          }
+        } catch {}
+      }
+
+      // Commands
+      if (text === "/new" || text === "/reset") {
+        sessions.delete(chatId);
+        await sendMessage(chatId, "🔄 New session");
+        continue;
+      }
+      if (text === "/status") {
+        await sendMessage(chatId, `Session: ${sessions.get(chatId) || "none"}\nModel: ${MODEL}\nWorkspace: ${WORKSPACE}`);
+        continue;
+      }
+      if (text === "/start") {
+        await sendMessage(chatId, `⚡ *ArmanBot*\n\nYour personal AI agent. I can execute commands, manage files, search the web, and more.\n\nJust ask me anything.\n\n/new — new session\n/status — current status`);
+        continue;
+      }
+
+      log(`IN [${chatId}]: ${text.slice(0, 100)}`);
+      const stopTyping = startTyping(chatId);
+
+      try {
+        const reply = await callClaude(chatId, text);
+        stopTyping();
+        await sendMessage(chatId, reply);
+        log(`OUT [${chatId}]: ${reply.slice(0, 100)}...`);
+
+        // Session log
+        try {
+          const today = new Date().toISOString().slice(0, 10);
+          const time = new Date().toTimeString().slice(0, 5);
+          appendFileSync(
+            `${WORKSPACE}/logs/session-${today}.md`,
+            `\n### ${time}\n**User:** ${text.slice(0, 200)}\n**Agent:** ${reply.slice(0, 500)}\n`
+          );
+        } catch {}
+      } catch (err) {
+        stopTyping();
+        await sendMessage(chatId, `⚠️ ${err.message}`);
+        log(`ERR [${chatId}]: ${err.message}`);
+      }
+    }
+  } catch (err) {
+    log(`POLL: ${err.message}`);
+  }
+}
+
+// ─── Signals ─────────────────────────────────────────────────
+process.on("SIGTERM", () => { log("Shutting down"); process.exit(0); });
+
+// ─── Start ───────────────────────────────────────────────────
+log("⚡ ArmanBot started");
+log(`Model: ${MODEL} | Timeout: ${TIMEOUT_MS / 1000}s | Workspace: ${WORKSPACE}`);
+
+async function run() {
+  while (true) {
+    await poll();
+    await new Promise((r) => setTimeout(r, 1000));
+  }
+}
+
+run();

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "armanbot-telegram",
+  "version": "1.0.0",
+  "description": "⚡ Personal AI Agent in Telegram — one file, full tool-use, persistent memory",
+  "main": "bot.mjs",
+  "bin": {
+    "armanbot": "bot.mjs"
+  },
+  "type": "module",
+  "scripts": {
+    "start": "node bot.mjs"
+  },
+  "keywords": ["ai", "agent", "telegram", "claude", "bot", "tool-use", "personal-assistant"],
+  "author": "Aray",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/armanbot-jpg/armanbot-telegram"
+  },
+  "homepage": "https://armanbot.kz",
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}