Skip to content

README.md

Latest commit

 

History

History
157 lines (117 loc) · 3.44 KB

README.md

File metadata and controls

157 lines (117 loc) · 3.44 KB

Ractor 🗃️

A lightweight .rac package manager for Linux

Version License Platform

Installation

curl -fsSL https://raw.githubusercontent.com/elezaio-linux/Ractor/main/install.sh | bash

Requirements

  • curl
  • tar
  • jq

These will be installed automatically via apt if missing.

Usage

ractor <command> [args]
Command Description
install <name|file.rac|url> Install a package
remove <name> Remove a package
update [name|--all] Update one or all packages
list List installed packages
search <query> Search the package index
info <name> Show package details
pack [directory] Create a .rac from a directory
verify <file.rac> Validate a .rac file
clean Clear cache and temp files
logs [lines] Show recent log entries
self-update Update ractor itself
version Show version
help Show help message

Examples

ractor install myapp.rac
ractor install https://example.com/pkg.rac
ractor install myapp
ractor update --all
ractor remove myapp
ractor search text-editor
ractor pack ./myapp/
ractor verify myapp.rac

Creating a Package

Directory Structure

myapp/
├── META                    # Package metadata (required)
├── binaries/               # Executables or app source (required)
├── afterinstall            # Post-install hook script (optional)
└── optional/
    └── recommended         # Suggested apt packages (optional)

META File

name=myapp
version=1.0.0
description=My awesome app
maintainer=yourname
depends=curl,git
type=binary
license=MIT
arch=any
Field Required Values
name ✅ Package name
version ✅ e.g. 1.0.0
description ❌ Short description
maintainer ❌ Your name
depends ❌ Comma-separated commands
type ❌ binary script react appimage
electron ❌ true or false (react only)
license ❌ e.g. MIT
arch ❌ x86_64 aarch64 any

Build & Install

ractor pack ./myapp/
ractor install myapp-1.0.0.rac

Package Types

Type Description
binary Compiled executables — copied directly to ~/.local/bin
script Shell scripts — copied directly to ~/.local/bin
react React/Node app — runs npm install + npm run build
appimage AppImage — wrapped with a launcher script

File Locations

Path Purpose
~/.local/bin/ractor Ractor itself
~/.local/bin/ Installed package binaries
~/.local/lib/ractor/ Installed package files
~/.local/share/ractor/installed/ Package records (JSON)
~/.local/share/ractor/cache/ Package index cache
~/.local/share/ractor/ractor.log Log file

Root installs use /usr/local/bin, /usr/lib/ractor, /var/lib/ractor

Configuration

Ractor reads config from (in order):

  • /etc/ractor.conf
  • ~/.config/ractor/ractor.conf

Updating Ractor

ractor self-update

License

MIT © elezaio-linux