beast-agent 0.15.0

package/.env.example

@@ -0,0 +1,7 @@
+# Beast Agent API anahtarları örneği.
+# Kullanım: bu dosyayı %APPDATA%\beast\.env olarak kopyala ve anahtarlarını gir.
+# Bu dosya config.yaml'daki key_env alanlarıyla eşleşir;
+# key_env yoksa <PROVIDER_ID>_API_KEY denenir (örn. zhipu -> ZHIPU_API_KEY).
+
+ZHIPU_API_KEY=
+OPENAI_API_KEY=

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 algokodcom (AlgoKod)
+
+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,94 @@
+# Beast Agent
+
+> **fast, light and resourceful** — a local agent shell for Windows. It chats, runs commands, writes files, searches the web, and is fully controllable from WhatsApp.
+
+![platform](https://img.shields.io/badge/platform-Windows-blue) ![license](https://img.shields.io/badge/license-MIT-green) ![electron](https://img.shields.io/badge/electron-40-47848F)
+
+**Website:** [beast.algokod.com](https://beast.algokod.com) · **AlgoKod:** [algokod.com](https://algokod.com)
+
+Beast Agent is a personal AI agent that runs on your machine and connects to **any OpenAI-compatible provider**. Define all your models in a single `config.yaml`; Beast handles the rest.
+
+## ✨ Features
+
+- **Multi-provider** — unlimited models from config.yaml; instant switching in the picker, role-based models (vision / terminal / coding / subagent)
+- **FALLOUT chain** ⚛ — if a model fails, Beast automatically moves to the next provider and resumes where it left off
+- **CEO mode** — the talking agent does no work itself; it delegates orders to parallel agents with a live monitoring panel
+- **WhatsApp integration** — pair via QR; DMs + groups (@mention), voice notes auto-transcribed by local Whisper, replies can be sent as voice notes too
+- **Slash commands** — `/new`, `/open`, `/change`, `/think`, `/rule`, `/allow`, `/block`, `/backup`, `/approve` and more
+- **Event center** — IMAP IDLE email watching, file-change watching, price feed (Binance), webhook inputs
+- **Cron + watchers** — scheduled tasks, file/web/battery watchers
+- **Web search chain** — TinyFish (free, used first if a key is set) → built-in browser (direct Google) → python multi-engine (DDG/Bing/Mojeek) → Exa
+- **Approval gate** — optional confirmation for risky actions (commands / file deletion-modification): default OFF (everything free), when ON the agent asks (`/approve`, `/approve always`, `/deny`)
+- **Provider-based limits** — per-provider max input token limit with context compression
+- **Encrypted backups** — all data is AES-256 encrypted and signed with your machine's unique **Beast Code**
+- **Dashboard** — session history, message statistics, cost tracking
+- **Full TR/EN interface** — everything switches language instantly
+- **/health** — `http://127.0.0.1:8788/health` liveness endpoint from the moment the app boots
+
+## 📦 Download
+
+### Installer (recommended)
+Grab `BeastAgent-Setup-x.x.x.exe` from the [Releases](../../releases) page. After install, Beast starts automatically with Windows (lives in the tray).
+
+### npm
+```bash
+npm install -g beast-agent
+```
+Then run `beast-agent` from any terminal. On first launch Beast creates a desktop shortcut and registers itself for auto-start.
+
+### From source
+```bash
+git clone https://github.com/algokodcom/beast-agent.git
+cd beast-agent
+npm install
+npm start
+```
+
+> Requirements: Node.js 18+, Windows 10/11. Python and ffmpeg are optional — Beast installs missing tooling itself.
+
+## ⚙️ Configuration
+
+1. Copy `config.example.yaml` → `config.yaml` and add your providers:
+```yaml
+defaultSelection: openrouter::anthropic/claude-3.5-sonnet
+providers:
+  - id: openrouter
+    name: OpenRouter
+    baseUrl: https://openrouter.ai/api/v1
+    apiKey: sk-or-...
+    models:
+      - anthropic/claude-3.5-sonnet
+      - gpt-4o
+```
+2. You can also provide API keys via `.env`: copy `.env.example` → `.env`
+3. On first launch, Settings → Provider pulls your models automatically.
+
+All app data lives under `%APPDATA%\beast` (sessions, memory, WhatsApp pairing, encrypted settings).
+
+## 🗣️ Usage
+
+| Where | What it does |
+|---|---|
+| Chat | Give it a task — it works on its own with tools (files, commands, web, python, browser) |
+| WhatsApp | Add your number to the allow list, control the agent from your phone |
+| Tray | Closing the window doesn't kill it — Beast keeps living in the tray |
+
+Type `/help` in the chat to see every command.
+
+## 🔒 Security & Privacy
+
+- Everything runs **locally**: sessions, memory and logs stay on your disk
+- API keys are never sent to the renderer in plaintext — masking is applied
+- Backups are AES-256 encrypted + signed with the Beast Code — only your machine can restore them
+- The approval gate is **off by default**; enable it from the Security tab if you want
+
+## 🧪 Development
+
+```bash
+npm test        # engine + tool tests (node --test)
+npm run dist    # NSIS + portable build
+```
+
+## 📄 License
+
+[MIT](LICENSE) © 2026 algokodcom (AlgoKod)

package/bin/beast-agent.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+'use strict';
+
+/* Beast Agent global npm başlatıcısı:
+   `beast-agent` komutu uygulamayı detached başlatır ve terminali hemen serbest bırakır. */
+
+const { spawn } = require('child_process');
+const path = require('path');
+
+const electron = require('electron');
+if (typeof electron !== 'string') {
+  /* electron runtime içindeyiz — bu script için anlamsız */
+  process.exit(1);
+}
+
+const appPath = path.resolve(__dirname, '..');
+const child = spawn(electron, [appPath, ...process.argv.slice(2)], {
+  stdio: 'ignore',
+  detached: true,
+  windowsHide: true,
+});
+child.unref();
+process.exit(0);

package/config.example.yaml

@@ -0,0 +1,26 @@
+# Beast Agent sağlayıcı yapılandırması örneği.
+# Kullanım: bu dosyayı %APPDATA%\beast\config.yaml olarak kopyala ve düzenle.
+# (Taşınabilir kullanım için BEAST_DATA ortam değişkeni ile başka klasöre alabilirsin.)
+
+providers:
+  zhipu:
+    name: Zhipu AI
+    base_url: https://api.z.ai/api/paas/v4
+    key_env: ZHIPU_API_KEY
+    models:
+      glm-4.6: {}
+      glm-4.5-air: {}
+
+  openai:
+    name: OpenAI
+    base_url: https://api.openai.com/v1
+    key_env: OPENAI_API_KEY
+    models:
+      gpt-4o-mini: {}
+      gpt-4o: {}
+
+model:
+  provider: zhipu      # varsayılan provider id (yoksa ilk provider kullanılır)
+  default: glm-4.6     # varsayılan model
+  # base_url: ...      # istersen aktif provider'ın URL'ini override et
+  # key_env: ...       # istersen anahtarı farklı env'den oku

package/package.json

@@ -0,0 +1,101 @@
+{
+    "name": "beast-agent",
+    "productName": "Beast Agent",
+    "version": "0.15.0",
+    "description": "Ultra-fast local agent shell for Windows.",
+    "author": "algokodcom (AlgoKod)",
+    "license": "MIT",
+    "homepage": "https://github.com/algokodcom/beast-agent#readme",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/algokodcom/beast-agent.git"
+    },
+    "bugs": {
+        "url": "https://github.com/algokodcom/beast-agent/issues"
+    },
+    "keywords": [
+        "agent",
+        "ai",
+        "whatsapp",
+        "assistant",
+        "electron",
+        "windows",
+        "llm",
+        "openai"
+    ],
+    "main": "src/main.js",
+    "bin": {
+        "beast-agent": "bin/beast-agent.js"
+    },
+    "scripts": {
+        "start": "electron .",
+        "dist": "electron-builder --win nsis portable",
+        "test": "node --test \"tests/**/*.test.js\"",
+        "prepublishOnly": "node scripts/swap-electron.js deps",
+        "postpublish": "node scripts/swap-electron.js devdeps"
+    },
+    "devDependencies": {
+        "electron-builder": "^26.15.3"
+    },
+    "dependencies": {
+        "@pdf-lib/fontkit": "^1.1.1",
+        "@whiskeysockets/baileys": "^7.0.0-rc14",
+        "@xenova/transformers": "^2.17.2",
+        "electron-updater": "^6.8.9",
+        "ffmpeg-static": "^5.3.0",
+        "imapflow": "^1.7.6",
+        "nodemailer": "^9.0.5",
+        "pdf-lib": "^1.17.1",
+        "pdf-parse": "^2.4.5",
+        "pdf-to-img": "^6.3.0",
+        "pdfjs-dist": "^5.6.205",
+        "pdfkit": "^0.20.1",
+        "qrcode": "^1.5.4",
+        "tesseract.js": "^7.0.0",
+        "ws": "^8.21.3",
+        "electron": "40.10.2"
+    },
+    "build": {
+        "appId": "com.quantumalgo.beastagent",
+        "productName": "Beast Agent",
+        "directories": {
+            "output": "dist"
+        },
+        "publish": [
+            {
+                "provider": "github",
+                "owner": "algokodcom",
+                "repo": "beast-agent"
+            }
+        ],
+        "files": [
+            "src/**/*",
+            "assets/**/*",
+            "!tests/**"
+        ],
+        "win": {
+            "target": [
+                "nsis",
+                "portable"
+            ],
+            "icon": "assets/app.ico"
+        },
+        "nsis": {
+            "oneClick": true,
+            "perMachine": false,
+            "createDesktopShortcut": "always",
+            "runAfterFinish": true,
+            "artifactName": "BeastAgent-Setup-${version}.exe"
+        },
+        "portable": {
+            "artifactName": "BeastAgent.exe"
+        },
+        "asarUnpack": [
+            "node_modules/ffmpeg-static/**",
+            "node_modules/@xenova/transformers/**",
+            "**/node_modules/@napi-rs/canvas/**",
+            "**/node_modules/tesseract.js/**",
+            "**/node_modules/tesseract.js-core/**"
+        ]
+    }
+}

package/scripts/swap-electron.js

@@ -0,0 +1,40 @@
+'use strict';
+
+/* electron yer değiştirici:
+   - `deps`   : electron'u devDependencies → dependencies taşır (npm publish öncesi;
+                global kurulumda electron runtime'ı inmesi için)
+   - `devdeps`: geri taşır (electron-builder yalnız devDependencies kabul eder;
+                repo normal durumu budur)
+   npm lifecycle: prepublishOnly → deps, postpublish → devdeps */
+
+const fs = require('fs');
+const path = require('path');
+
+const mode = process.argv[2];
+const pkgPath = path.join(__dirname, '..', 'package.json');
+const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+const VER = pkg.devDependencies && pkg.devDependencies.electron
+  ? pkg.devDependencies.electron
+  : (pkg.dependencies && pkg.dependencies.electron);
+
+if (!VER) {
+  console.error('electron sürümü package.json içinde bulunamadı');
+  process.exit(1);
+}
+
+if (mode === 'deps') {
+  delete pkg.devDependencies.electron;
+  pkg.dependencies = pkg.dependencies || {};
+  pkg.dependencies.electron = VER;
+  console.log('electron → dependencies (' + VER + ')');
+} else if (mode === 'devdeps') {
+  delete pkg.dependencies.electron;
+  pkg.devDependencies = pkg.devDependencies || {};
+  pkg.devDependencies.electron = VER;
+  console.log('electron → devDependencies (' + VER + ')');
+} else {
+  console.error('kullanım: node scripts/swap-electron.js deps|devdeps');
+  process.exit(1);
+}
+
+fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 4) + '\n');