Skip to content
munimentaiPublic

About

Your models, working together: a free desktop app for your models, tools, and files. Read-only mirror.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2,379 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Muniment

Your models. Working together.

A free desktop app for your models, tools, and files. No Muniment account required.

Website · Docs · Get the app · Getting started

Free desktop · Source under FSL.

Muniment desktop with project threads, Jev selected, and a launch readiness artifact beside the chat. Sample data.

Features

  • Your models, together. Connect provider accounts, API keys, or local models. Choose a model or let Jev route each request.
  • One workspace. Keep projects, chats, files, a terminal, and a browser together.
  • Tools that fit your work. Add MCP servers, skills, and plugins. Choose what each turn can use.
  • Agents and artifacts. Create reusable agents and interactive outputs beside the conversation.
  • Memory and voice. Keep context across chats and use on-device voice.

Start

Download Muniment for your platform:

See the install guide for platform requirements and all downloads for alternate installers.

Open the app, connect a provider, and start a thread. Follow the getting started guide for your first project.

AppImage sandbox setup

Ubuntu 24.04 restricts unprivileged user namespaces. The AppImage needs a host sandbox helper on these systems, even without the DEB. The AppImage includes a setup script and the Chromium sandbox helper.

  1. Download the AppImage from the official release.
  2. In an empty directory, extract its sandbox setup.
chmod +x /path/to/muniment.AppImage
/path/to/muniment.AppImage --appimage-extract usr/lib/muniment/cef/chrome-sandbox
/path/to/muniment.AppImage --appimage-extract setup-sandbox.sh
  1. Install the helper with administrator access.
sudo /bin/sh squashfs-root/setup-sandbox.sh
  1. Remove the extracted files.
rm -r squashfs-root
  1. Run the original AppImage as your normal user.

The setup requires a setuid-enabled executable filesystem at /usr/lib/muniment/cef. It keeps Chromium's sandbox enabled and leaves the host's user namespace policy unchanged. Run setup for each AppImage update. Matching helpers need no changes. If setup reports a different helper, keep the DEB helper when the DEB is installed. For an AppImage-only installation, close Muniment and remove /usr/lib/muniment/cef/chrome-sandbox with sudo rm before setup. To uninstall an AppImage-only installation, remove that helper and the AppImage.

Homebrew

The official Homebrew cask is not available yet. Use the macOS download above. Once Homebrew accepts the cask, install with:

brew install --cask muniment

Releases

GitHub Releases on munimentai/muniment host every download. Forgejo Actions at factory/muniment build and publish them. Only an owner dispatch of main runs a release job. Each job checks this in its first step and fails before any credential is read.

  1. Dispatch nightly.yml on main. It signs the three platform builds, uploads them to the nightly pre-release, and runs the installed checks.
  2. Dispatch subscriptions.yml on GitHub with the nightly source SHA. Its native runners are on GitHub.
  3. Dispatch release.yml on main with the source SHA, the version, and dry_run set. The dry run runs every check and creates nothing.
  4. Dispatch release.yml again without dry_run. It creates the version tag on Forgejo, and the push mirror carries it to GitHub. The job then publishes the verified nightly bytes, latest.json, and SHA256SUMS as the stable release.

The GH_RELEASE_TOKEN secret holds a fine-grained GitHub token with Contents write on munimentai/muniment. Every GitHub Releases call uses it. The job token reaches only Forgejo.

Issues and license

Report a bug or request a feature by email to [email protected]. Outside code contributions are not accepted. See CONTRIBUTING.md and SECURITY.md for issue and private vulnerability reports.

Muniment uses FSL-1.1-ALv2, a Fair Source license. Each version converts to Apache 2.0 after two years. Third-party components retain their own licenses. See the test architecture for verification details.

npm run check:agent-dependencies checks Claude Code, Pi, and extension pins against current releases and Pi peer ranges. Updates require the focused regression tests and the native CI and installed nightly checks. npm run test:agent-runtime checks extension loading, selected models, streamed completion, and cache usage against a local fixture. Set PI_TEST_BINARY to the verified Pi executable and PI_TEST_PACKAGES to an isolated frozen install of pins/packages.bun.lock from the muniment-core release tag.

About

Your models, working together: a free desktop app for your models, tools, and files. Read-only mirror.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages