Vix.cpp A modern C++ runtime for real-world systems. Build HTTP, WebSocket, and peer-to-peer applications with predictable performance and offline-first reliability. 🌍 Website · 📘 Docs · ⬇️ Download

---

Contents

• Install
• Build from source
• Your first Vix.cpp program
• Script mode
• Shell completion
• Why Vix.cpp
• Performance
• Core principles
• Learn more
• Contributing

---

Install

Linux

sudo apt update
sudo apt install -y \
  build-essential cmake ninja-build pkg-config \
  libssl-dev libsqlite3-dev zlib1g-dev

macOS Dependencies (example)

brew install cmake ninja pkg-config openssl@3

Shell (Linux, macOS)

curl -fsSL https://vixcpp.com/install.sh | bash

PowerShell (Windows)

irm https://vixcpp.com/install.ps1 | iex

Verify installation:

vix --version

Build from source

git clone --recurse-submodules https://github.com/vixcpp/vix.git
cd vix

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j

# Install for current user (recommended)
cmake --install build --prefix "$HOME/.local"

# Ensure PATH contains ~/.local/bin then restart your terminal
vix --version
vix doctor

Your first Vix.cpp program

Create a file called server.cpp:

#include <vix.hpp>
using namespace vix;

int main() {
  App app;

  app.get("/", [](Request&, Response& res) {
    res.send("Hello, world!");
  });

  app.run(8080);
}

Run it:

vix run server.cpp

Open http://localhost:8080 That’s it.

---

Script mode (no project setup)

Run C++ like a script:

vix run main.cpp

Shell completion

Enable tab completion for Vix commands.

source <(vix completion bash)

Make it permanent:

vix completion bash > ~/.vix-completion.bash
echo 'source ~/.vix-completion.bash' >> ~/.bashrc

Learn more: https://vixcpp.com/docs/modules/cli/completion

Why Vix.cpp

Most systems assume perfect conditions. Vix is built for when things are not.

• predictable under load
• no GC pauses
• offline-first by design
• deterministic execution
• minimal setup

---

Performance

Stable under sustained load.

Metric	Value
Requests/sec	~66k – 68k
Avg Latency	~13–20 ms
P99 Latency	~17–50 ms

---

Core principles

• Local-first execution
• Network is optional
• Deterministic behavior
• Failure-tolerant
• Built for unreliable environments

---

Learn more

• Docs: https://vixcpp.com/docs
• Registry: https://vixcpp.com/registry
• Examples: https://vixcpp.com/docs/examples

---

Contributing

Contributions are welcome.

Focus areas

• performance
• reliability
• networking
• offline-first systems

---

MIT License