Your Mac. Your Models. Your Rules.

A native local AI workspace for Apple Silicon — run, fine-tune, and benchmark language models
entirely on your own machine, with no data leaving your desk.

---

What Is Melix?

Melix is a complete local AI operations platform built for Apple Silicon Macs. It brings together everything you need to work with language models — serving, fine-tuning, benchmarking, and evaluation — in a single native app and CLI, with no subscriptions, no cloud dependencies, and no data leaving your machine.

Think of it as a local AI studio: a place where you can load a model, adapt it to your needs, measure its quality, and compare results — all from your own hardware.

---

What You Can Do With Melix

Why Melix?

Local AI work tends to scatter across too many tools: one script for serving, another for training, a notebook for evaluation, and a shell history for benchmarks. Melix keeps that entire loop in one place, on one machine.

• Privacy by default. Your models, your data, your results — none of it leaves your Mac.
• No subscriptions. Run any compatible model as many times as you like at zero marginal cost.
• Repeatable science. Benchmark and evaluation results are stored in a repository-owned format so comparisons stay honest over time.
• Operator-grade UI. The native macOS workspace is a first-class citizen, not an afterthought.

Who Is Melix For?

• AI practitioners on Apple Silicon who want a local runtime instead of a remote-only workflow
• Model engineers who need a repeatable loop for LoRA fine-tuning, comparison, and evaluation
• Privacy-conscious builders who want full control over inference without cloud APIs
• Local AI enthusiasts who want a polished native macOS experience alongside the CLI
• Contributors who care about typed protocols, reproducible runbooks, and productized local tooling

---

Quick Start

Make sure you have macOS 15+ on Apple Silicon, plus swift, python3, and uv installed.

# 1. Bootstrap the repository
make bootstrap

# 2. Generate protocol artifacts
make proto

# 3. Run verification gates
make swift-test
make py-test
make integration-test

Then bring up the local stack:

bash scripts/dev_up.sh

For the full native macOS experience:

bash scripts/dev_app_up.sh

New here? The Getting Started guide walks through every step with context.

---

Documentation

---

Contributing

Contributions are welcome — documentation, tooling, protocol, runtime, CLI, and macOS operator surface. Start with docs/contributing.md for the workflow, verification commands, and handoff expectations.

The short version:

1. Branch from main.
2. Keep the change small and focused on one behavior slice.
3. Update the relevant spec or runbook if behavior changes.
4. Run make swift-test && make py-test && make integration-test before opening a PR.

---

License

Melix is licensed under the Apache License, Version 2.0. See LICENSE.