dorkhub

project-golem

OS-level autonomous AI agent with long-term memory, multi-agent coordination, Titan Chronos scheduler & Moltbot Social…

Arvincreator
JavaScript633104 forksupdated 1 month ago
git clone https://github.com/Arvincreator/project-golem.gitArvincreator/project-golem
Project Golem Logo

Project Golem

你的 AI 操作中樞:可對話、可行動、可記憶、可長期協作。

version node backend dashboard

English README · 貢獻指南 · 開發代理指南


Project Golem 是什麼

Project Golem 不是單純聊天機器人,而是一套可運行的 AI 工作系統。
它把「語言模型能力」和「實際操作能力」整合成同一個執行核心,讓你可以在一個 Dashboard 裡完成:

  • 即時對話與任務協作
  • 技能掛載與工具擴充(MCP / Skills)
  • 長期記憶管理與檢索
  • 多代理討論與共識彙整
  • RPG 劇情互動、股市看板、協作日曆、羈絆日記
  • 系統安全、設定、更新與維運

你可以使用:

  • Gemini Web(Browser-in-the-Loop,透過 Playwright)
  • Ollama(本機/私有模型)
  • LM Studio(OpenAI-compatible local API)

為什麼它有價值

多數 AI 工具在「一次對話」很強,但在「長期工作」會掉鏈。Project Golem 的設計重心是讓 AI 在真實環境裡持續可用:

  • 有狀態:保留長期上下文與記憶
  • 有行動:可透過工具與技能執行任務
  • 有邊界:具備安全控管與操作限制
  • 有介面:透過 Web Dashboard 做人機協作與治理

適合的使用場景

場景 Golem 可以做什麼
個人 AI 工作台 把對話、記憶、工具、設定集中到同一個 Dashboard,不需要在多個 AI 網頁之間切換。
本機私有 AI 使用 Ollama 或 LM Studio,讓模型推理與記憶資料留在自己的機器或私有網路內。
長期專案陪跑 透過記憶核心、摘要與技能系統,讓 AI 累積專案背景,而不是每次都重新解釋。
多代理決策 建立不同角色進行討論,例如產品、工程、安全、營運,再整理成可執行結論。
工具型代理實驗 用 MCP 與 Skills 把搜尋、檔案、外部服務、專案工具逐步接進 AI 工作流。
生活與創作陪伴 用文字 RPG、羈絆日記、協作日曆,把 AI 從工具延伸成可共同規劃、共同記錄的互動角色。
金融資訊看板 透過台股/美股股市看板,整理行情、新聞、技術指標與 watchlist,交給 Golem 做分析上下文。

核心能力

能力 說明
多後端大腦 支援 geminiollamalmstudio,可依成本、隱私、效能切換。
Web Dashboard 預設 http://localhost:3000/dashboard,提供對話、監控、設定、技能、MCP、記憶管理。
長期記憶 支援 lancedb-pronative 記憶模式,含摘要壓縮與檢索流程。
多代理協作 Interactive Multi-Agent 模式可建立角色群組做討論與共識輸出。
技能系統 可載入內建/自訂技能,支援安裝、啟用、測試與管理。
MCP 工具擴充 可接入標準 I/O MCP server,將外部能力接進 Golem 工作流。
股市看板 支援台股/美股 watchlist、行情、K 線、技術指標、新聞脈絡與 Golem 分析快照。
協作日曆 Dashboard 行事曆可建立、更新、刪除行程,並提供 Golem 可讀取的協作排程資料。
文字 RPG 原生文字 RPG 模式,支援世界觀/角色建立、選項互動、會員回合數與外部通道綁定。
羈絆日記 使用者日記、AI 日記、AI 想法、週摘要、羈絆等級、SQLite 備份與還原流程。
外部通道 可選 Telegram / Discord bridge。
安全治理 遠端存取保護、操作 token、風險命令防護、權限檢查。

介面預覽

Skills

Memory Core

Stocks

MCP Tools

Calendar

Text RPG

System Settings

目前 Dashboard(web-dashboard/src/app/dashboard)的主路由包含:

  • /dashboard:Unified Console(Overview + 即時狀態)
  • /dashboard/chat:聊天工作台
  • /dashboard/diary:羈絆日記
  • /dashboard/persona:人格設定
  • /dashboard/prompt-pool:Prompt Pool
  • /dashboard/prompt-trends:Prompt 趨勢分析
  • /dashboard/stocks:股市看板
  • /dashboard/calendar:協作日曆
  • /dashboard/rpg:文字 RPG
  • /dashboard/skills:技能管理
  • /dashboard/mcp:MCP 管理
  • /dashboard/action-gate:Action Gate(高風險操作核准流)
  • /dashboard/agents:代理清單
  • /dashboard/office:Agent 辦公室 / 協作空間
  • /dashboard/memory:記憶核心
  • /dashboard/memory-firewall:記憶防火牆
  • /dashboard/reference-files:Reference Files
  • /dashboard/settings:系統設定總覽

快速開始

1) 環境需求

  • Node.js >=20 <23
  • npm
  • Chromium / Google Chrome(Gemini Web 模式需要)

2) 安裝與啟動(推薦)

Windows(請使用 Git Bash):

cd /你的/project-golem-main/資料夾
./setup.sh

macOS(請使用終端機 Terminal):

cd /你的/project-golem-main/資料夾
./setup.sh

按下 Enter 後,系統會自動引導你完成安裝或進入啟動選單。


最常用指令

指令 說明
npm run dashboard 啟動 runtime + Web Dashboard
npm start 啟動核心 runtime
npm run dev 開發模式(nodemon)
npm run doctor 環境健康檢查
npm run arch:check 架構邊界檢查
npm test 執行測試

常用對話指令

指令 說明
/help 查看目前可用指令
/new 開新對話並載入相關記憶
/new_memory 重置底層記憶狀態
/skills 查看已安裝技能
/learn <功能> 讓 Golem 嘗試學習或生成新技能
/stocks TSM NVDA 2330 建立即時股市分析上下文
/stockboard 開啟股市看板式分析上下文
/rpg start 啟動原生文字 RPG 模式
/rpg bind 產生會員/外部通道綁定碼
/install skill-gh <url> 從 GitHub 安裝技能
/install mcp-url <url> 從 HTTPS JSON 安裝 MCP 設定

核心設定範例

Gemini Web(預設)

GOLEM_BACKEND=gemini
GOLEM_MEMORY_MODE=lancedb-pro
PLAYWRIGHT_STEALTH_ENABLED=true
ALLOW_REMOTE_ACCESS=false

Ollama

GOLEM_BACKEND=ollama
GOLEM_OLLAMA_BASE_URL=http://127.0.0.1:11434
GOLEM_OLLAMA_BRAIN_MODEL=llama3.1:8b
GOLEM_EMBEDDING_PROVIDER=ollama
GOLEM_OLLAMA_EMBEDDING_MODEL=nomic-embed-text

LM Studio

GOLEM_BACKEND=lmstudio
GOLEM_LMSTUDIO_BASE_URL=http://127.0.0.1:1234/v1
GOLEM_LMSTUDIO_BRAIN_MODEL=local-model
GOLEM_LMSTUDIO_API_KEY=

遠端管理安全建議

ALLOW_REMOTE_ACCESS=false
REMOTE_ACCESS_PASSWORD=
SYSTEM_OP_TOKEN=

若要開放遠端,請務必同時設定強密碼、token,並搭配防火牆或 VPN。


部署方式

本機開發與個人使用建議直接跑 Node.js。若要部署到伺服器或 VPS,可以使用 Docker Compose 或 headless/noVNC 流程。

docker compose up -d --build

更多部署細節請看 Docker 本機部署指南VPS VNC Setup Guide


專案結構

project-golem/
├── apps/
│   ├── runtime/              # 核心啟動入口
│   └── dashboard/            # Dashboard plugin / app layer
├── src/                      # 核心邏輯(brain, manager, services, bridges)
├── web-dashboard/            # Next.js Dashboard 與前端頁面
├── packages/                 # memory / protocol / security 等共享模組
├── docs/                     # 文件與指南
├── assets/                   # README 截圖素材
├── index.js                  # 相容入口(轉交 apps/runtime)
└── dashboard.js              # 相容入口(Dashboard 啟動)

文件地圖


授權

本專案採 Source-Available Non-Commercial 授權。
請參考:LICENSECOMMERCIAL-LICENSE.md


作者

Arvin Chen

more like this

lottery

🎉🌟✨🎈年会抽奖程序,基于 Express + Three.js的 3D 球体抽奖程序,奖品🧧🎁,文字,图片,抽奖规则均可配置,😜抽奖人员信息Excel一键导入😍,抽奖结果Excel导出😎,给你的抽奖活动带来全新酷炫体验🚀🚀🚀

JavaScript4.6k

Agent-Signal-Bar

本地优先的 macOS AI Agent 信号灯:状态栏 + 桌面悬浮信号灯,自动监控 Codex / Claude Code。Local menu bar and floating desktop status lights for A…

Swift53

search

search projects, people, and tags