magnitude README

The project's README from github.com/magnitudedev/magnitude. As one markdown file: README.md.

Magnitude icon

Magnitude

The best way to run local models on your machine

Documentation Discord Follow Magnitude on Twitter GitHub Repo stars npm version

Magnitude is an open source inference server for the hardware you already have. It profiles your machine, recommends the right models for it, then downloads, tunes, and runs them. Plug it into Pi, OpenCode, Hermes, OpenClaw, Codex, Claude Code, Oh My Pi, and Cline, or use the built-in harness.

⭐ Help us reach more developers and grow the Magnitude community. Star this repo!

Magnitude demo: run local models on your machine

Get started

See what your Mac can run:

npm i -g @magnitudedev/cli
magnitude setup

Setup profiles your hardware, ranks models by speed, accuracy, intelligence, and memory, and connects your harness to the one you pick.

Or let your agent handle it. Send this to Pi, Claude Code, OpenCode, or whatever you use:

Set up local models for me with the Magnitude CLI. Install it with `npm i -g @magnitudedev/cli` (or my package manager), then run `magnitude docs onboarding` and follow the instructions.

Your agent will profile your hardware, walk you through the best local models for it, download the ones you pick, and switch itself over to them.

Why Magnitude?

FAQ

What is Magnitude?

An open source inference server for the hardware you already have. It profiles your machine, recommends the right models for it, then downloads, tunes, and runs them. Plug it into the agent you already use.

How does it know what my machine can run?

Magnitude profiles your chip, memory, and bandwidth, then estimates fit and tok/s for every model in the catalog. It ranks them by speed, accuracy, intelligence, and memory so you can pick.

What hardware do I need?

There's no fixed minimum. Magnitude profiles your machine and recommends what runs well on it. More memory lets you run larger models.

What platforms does it support?

macOS, Linux, and Windows through WSL. Metal, CUDA, and Vulkan on the GPU side, or CPU only. Magnitude profiles whatever you have and recommends models that fit.

Which harnesses work with it?

Pi, OpenCode, Hermes, OpenClaw, Codex, Claude Code, Oh My Pi, and Cline. During setup, your agent connects your harness to the model you pick. Or use Magnitude's built-in harness.

Do I need to manage it after setup?

No. It runs in the background, loads models when your agent needs them, and unloads them when idle or memory gets tight. Your agent can install or switch models through the CLI anytime.

Is it private?

Yes. Prompts, files, and models stay on your machine. Once a model is downloaded, no internet connection is needed.

Learn more

License

Magnitude is licensed under the Apache License 2.0.

magnitude (magnitudedev/magnitude)

Searching Database…

What is this?Magnitude is an open source inference server that profiles your machine, recommends local models that fit it, then downloads, tunes, and runs them for your coding agent.
Is this a library or a standalone server I run?It is a standalone inference server/CLI that runs in the background on your machine; you connect it to an existing coding agent (harness) rather than embed it as a library.
How do I get it running?Run the setup command so it profiles your hardware, ranks models, and connects your harness to the one you pick; you can also just tell your agent (Pi, Claude Code, OpenCode, etc.) to handle setup for you.
Which coding agents (harnesses) does it plug into?It works with Pi, OpenCode, Hermes, OpenClaw, Codex, Claude Code, Oh My Pi, and Cline, or you can use Magnitude's built-in harness.
Is there a minimum hardware requirement?There's no fixed minimum spec; Magnitude profiles your machine and recommends whatever models run well on it, with more memory enabling larger models.
Does it run on Windows, or just macOS and Linux?It supports macOS, Linux, and Windows (via WSL), using Metal, CUDA, or Vulkan on the GPU side, or CPU only.
Does any of my data leave my machine?No — prompts, files, and models stay local, and once a model is downloaded no internet connection is needed.
How is Magnitude faster than llama.cpp?It compiles and tunes its own kernels specifically for your device, including speculative decoding, so open models run up to 2x faster than llama.cpp on the same hardware.
Does it cost anything to run?No, it's free to run with no token costs, API keys, or rate limits since everything runs on your own hardware.
What happens to models when I'm not using them?Models are loaded on demand when your agent needs them and automatically unloaded when idle or when memory gets tight.
Size
137.8 MB
Stars
7K
Age
4mo
Commits · 90 Days