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…

Что это такое?Magnitude — это открытый сервер инференса, который определяет характеристики вашего компьютера, подбирает локальные модели, которые на нём будут работать, а затем скачивает, настраивает и запускает их для вашего агента для программирования.
Это библиотека или отдельный сервер, который я запускаю?Это самостоятельный сервер инференса/CLI, который работает в фоновом режиме на вашем компьютере; вы подключаете его к существующему агенту для программирования (харнесу), а не встраиваете как библиотеку.
Как это запустить?Запустите команду настройки: она определит характеристики железа, составит рейтинг моделей и подключит ваш харнес к выбранной модели. Также можно просто попросить вашего агента (Pi, Claude Code, OpenCode и др.) выполнить настройку за вас.
С какими агентами для программирования (харнесами) он работает?Он работает с Pi, OpenCode, Hermes, OpenClaw, Codex, Claude Code, Oh My Pi и Cline, а также можно использовать встроенный харнес Magnitude.
Есть ли минимальные требования к железу?Фиксированного минимума нет: Magnitude определяет характеристики вашего компьютера и рекомендует модели, которые на нём хорошо работают; чем больше памяти, тем крупнее модели можно запустить.
Работает ли он на Windows или только на macOS и Linux?Поддерживаются macOS, Linux и Windows (через WSL); для видеокарты (GPU) используются Metal, CUDA или Vulkan, либо только процессор (CPU).
Покидают ли мой компьютер какие-либо данные?Нет — промпты, файлы и модели остаются локально, а после загрузки модели интернет-соединение не нужно.
Чем Magnitude быстрее llama.cpp?Он компилирует и настраивает собственные вычислительные ядра специально под ваше устройство, включая спекулятивное декодирование, поэтому открытые модели работают до 2x быстрее, чем в llama.cpp на том же железе.
Стоит ли его запуск денег?Нет, запуск бесплатный: без оплаты за токены, API-ключей и лимитов запросов, поскольку всё работает на вашем собственном железе.
Что происходит с моделями, когда я их не использую?Модели загружаются по требованию, когда агенту нужна модель, и автоматически выгружаются, когда простаивают или когда памяти начинает не хватать.
Size
138.3 MB
Stars
7.1K
Age
4mo
Commits · 90 Days