Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

[Feature] A desktop control panel so non-developers can run OpenMuse without terminals

未关闭
#78 2 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
35/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
electron, tauri, typescript
领域
desktop

调研方向

Start by reviewing the existing pnpm dev, pnpm dev:web, and pnpm dev:browser entry points and the .env configuration; the issue does not name implementation files or select a desktop framework. Define the platform and setup flow before implementing process health, model switching, and login startup. Done means the stated fresh-clone, model-switching, and clean-stop checks pass.

由索引模型根据 Issue 内容生成。

描述

What outcome should OpenMuse handle?

Starting, stopping and configuring a self-hosted OpenMuse without touching a terminal.

Today, running OpenMuse locally means keeping two or three terminal windows open (pnpm dev, pnpm dev:web, pnpm dev:browser), editing .env by hand to change models, and restarting processes after every change. That's fine for developers, but it's the main thing standing between OpenMuse and people who'd love a personal agent but have never used a terminal. I'm one of those people, and it's where I got stuck.

Proposed behavior

A small desktop companion app that wraps the existing scripts. I have a working macOS menu bar prototype, built with Claude Code:

  • One button to start/stop everything: server, web app and browser worker, with a status light for each (off / starting / running / failed + a link to logs).
  • Open OpenMuse button that lights up once the web app and server are healthy.
  • Model picker: lists local models (LM Studio in my prototype, filtered to models that support tool use), writes MODEL= to .env, restarts the server, and loads the new model in LM Studio right away so the switch is visible.
  • Starts the local model server (LM Studio) if it isn't running.
  • "Start OpenMuse when I log in" toggle.
  • Links to logs and the settings file.

It doesn't change OpenMuse itself: it only runs the existing pnpm scripts and edits .env.

Screenshot of the prototype:

OpenMuse Control prototype panel

To make it useful beyond my setup, it would need:

  • a first-run setup (choose the OpenMuse folder, the CopilotKit key step, generating WORKER_TOKEN)
  • support for Ollama and cloud providers, not just LM Studio
  • a cross-platform answer, e.g. a Tauri/Electron app, or making this part of the web app itself
  • signing and distribution

Happy to share the prototype code if it's useful. I wanted to check whether this fits the project's direction before building it any further.

How would we verify it works?
  • From a fresh clone with .env configured: click Start → all three services report healthy → Open OpenMuse loads localhost:8081 and a chat message gets a reply.
  • Change the model in the picker → the next request to the model provider uses the new model ID (checked in LM Studio's server log).
  • Stop → no OpenMuse processes left listening on 8787, 8081 or 8790.
  • Platform dependencies: macOS 14+ for the prototype; LM Studio's lms CLI for the local model features.

Co-signed,
Zach, who wanted this
Claude (Claude Code, Anthropic), who built the prototype

主要语言
TypeScript
星标
5.2k
派生
730
平均合并
3 天 20 小时
30 天内合并 PR
96

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

CopilotKit/openmuse 的其他 Issue

查看 CopilotKit/openmuse 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。