</div> <h4 align="center"> <a href="https://soar.qaidvoid.dev">📘 Documentation</a> | </h4> <p align="center"> A fast, modern, bloat-free distro-independent package manager that <i>just works</i><br> Supports static binaries, AppImages, and other Portable formats (AppBundle, FlatImage, RunImage, Wrappe, etc.) on any Linux distribution. </p>

📦 What is Soar?

Soar is a package manager - it doesn't build or host packages itself. Instead, it consumes package metadata from repositories and handles downloading, installing, and managing packages on your system.

How it works:

Repositories (like soarpkgs - the default) build and host packages, providing metadata in a standard format
Soar fetches this metadata, lets you search/install packages, and manages your local installations
You can use soarpkgs, add third-party repos, or even create your own

This separation means Soar works with any compatible repository - it's not tied to a specific package source.

🪄 Quickstart

[!TIP]

Soar comes as a single-file, statically-linked executable with no dependencies that you can simply download & run.

The install script does this & more automatically for you.

# cURL
curl -fsSL "https://raw.githubusercontent.com/pkgforge/soar/main/install.sh" | sh

# wget
wget -qO- "https://raw.githubusercontent.com/pkgforge/soar/main/install.sh" | sh

[!NOTE]

Please read & verify what's inside the script before running it

The script is also available through https://soar.qaidvoid.dev/install.sh

Additionally, if you want to customize your installation, please read the docs @ https://soar.qaidvoid.dev/installation.html

Next, check Configuration & Usage

🌟 Key Features

| Feature | Description | |:--:|:--| | Universal | Single binary, no dependencies, works on any Unix-like system without superuser privileges. | | Portable Formats | Install static binaries, AppImages, and other self-contained archives with ease. | | System Integration | Automatically adds desktop entries and icons for a native feel. | | Repository Agnostic | Works with any repository that provides compatible metadata. Use official soarpkgs repo, third-party sources, or create your own. | | Security First | Enforces security through checksums and signature verification for package installations. | | Fast & Efficient | Minimal overhead with parallel downloads and efficient package operations. |

🤝 Contributing

We welcome contributions! Please feel free to fork the repository and submit pull requests. See CONTRIBUTING.md for contribution guidelines.

💬 Contact

We have a growing community on discord to discuss not only Soar/Pkgforge but also other cool projects, feel free to join & hangout anytime.

Minimum Supported Rust Version (MSRV)

v1.88.0

Soar

Install / Use

README