Skip to content

loganbek/1install

Repository files navigation

1install (1i) 🚀

One command to rule them all.

Version License: MIT Build Status

1install is a high-performance, unified package meta-orchestrator. It provides a single, consistent interface for searching, installing, updating, and managing software across multiple package managers and ecosystems.


⚡ Quick Start (v1.1.0)

Get up and running in seconds. Choose the one-liner for your OS:

Unix (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/loganbek/1install/main/scripts/install.sh | sh

Windows (PowerShell)

iwr -useb https://raw.githubusercontent.com/loganbek/1install/main/scripts/install.ps1 | iex

✨ Key Features

  • 🔍 Unified Federated Search: Search across apt, winget, brew, npm, pip, snap, flatpak, and more—simultaneously.
  • 🛡️ Integrity Verification: Automated SHA-256 hash checking for secure installations.
  • 🔄 Transactional Rollbacks: If an installation fails, 1install rolls back changes to keep your system clean.
  • 🚀 Shim Engine: Instant binary availability without shell restarts or PATH tinkering.
  • 📦 Multi-Backend Support:
    • System: apt, pacman, dnf, winget, brew
    • Universal: snap, flatpak
    • Language: npm, pip, cargo, go
    • Source: Directly install from git repositories.

🛠️ Usage

Search for anything

1i search ripgrep

Install with a specific backend (or let 1i decide)

1i install jq
1i install node --backend npm

Secure installation (v1.0.0+)

1i install ripgrep --verify <SHA256_HASH>

Manage Lifecycle

1i update 1i
1i uninstall git

System Health

1i doctor    # Detect conflicts and broken shims

🏗️ Architecture

1install is built in Rust for maximum speed and safety. It uses the Adapter Pattern to wrap existing package managers, providing a normalized data model and transactional execution.

For detailed architectural specs, see the docs/ directory.


☕ Support & Donations

If 1install has saved you time and improved your workflow, consider supporting its future development! Your contributions help recoup server costs and maintenance time.

  • Ethereum (ETH): loganbek.eth

📊 Telemetry & Active Users

To help us prioritize features and understand our impact, 1install includes anonymized, privacy-first telemetry. We track:

  • Total number of active users (anonymized UUID)
  • Command success/failure rates
  • Backend performance metrics

Telemetry is Opt-Out. If you prefer not to share this data, you can disable it with:

1i config set telemetry.enabled false

🖋️ Authors

  • Logan Bek
  • Antigravity (AI Co-Author)
  • Claude Opus (Architectural Planning)

⚖️ License

Distributed under the MIT License. See LICENSE for more information.

About

One command to rule them all.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published