ინსტალაცია

PRX მოწოდებულია ერთი სტატიკური ბინარის სახით, სახელწოდებით prx. აირჩიეთ ინსტალაციის მეთოდი, რომელიც შეესაბამება თქვენს სამუშაო პროცესს.

წინაპირობები

PRX-ის ინსტალაციამდე დარწმუნდით, რომ თქვენი სისტემა აკმაყოფილებს ამ მოთხოვნებს:

მოთხოვნა	დეტალები
ოპერაციული სისტემა	Linux (x86_64, aarch64), macOS (Apple Silicon, Intel) ან Windows WSL2-ის მეშვეობით
Rust	1.92.0+ (2024 გამოცემა) -- საჭიროა მხოლოდ Cargo ინსტალაციისთვის ან წყაროდან აგებისთვის
სისტემური პაკეტები	pkg-config (Linux, მხოლოდ წყაროდან აგებისთვის)
დისკის სივრცე	~50 MB ბინარისთვის, ~200 MB WASM დანამატის გაშვების გარემოსთან ერთად
ოპერატიული მეხსიერება	მინიმუმ 64 MB დემონისთვის (LLM ინფერენსის გარეშე)

TIP

თუ იყენებთ ინსტალაციის სკრიპტს ან Docker-ს, Rust-ის ინსტალაცია თქვენს სისტემაზე არ არის საჭირო.

მეთოდი 1: ინსტალაციის სკრიპტი (რეკომენდებული)

დაწყების ყველაზე სწრაფი გზა. სკრიპტი ამოიცნობს თქვენს ოპერაციულ სისტემას და არქიტექტურას, ჩამოტვირთავს უახლესი რელიზის ბინარს და განათავსებს თქვენს PATH-ში.

curl -fsSL https://openprx.dev/install.sh | bash

სკრიპტი ნაგულისხმევად აინსტალირებს prx-ს ~/.local/bin/ დირექტორიაში. დარწმუნდით, რომ ეს დირექტორია თქვენს PATH-შია:

export PATH="$HOME/.local/bin:$PATH"

კონკრეტული ვერსიის ინსტალაციისთვის:

curl -fsSL https://openprx.dev/install.sh | bash -s -- --version 0.3.0

მორგებულ დირექტორიაში ინსტალაციისთვის:

curl -fsSL https://openprx.dev/install.sh | bash -s -- --prefix /usr/local

მეთოდი 2: Cargo ინსტალაცია

თუ Rust-ის ინსტრუმენტარიუმი დაინსტალირებული გაქვთ, შეგიძლიათ PRX-ის ინსტალაცია პირდაპირ crates.io-დან:

cargo install openprx

ეს აგებს რელიზის ბინარს ნაგულისხმევი ფუნქციებით და განათავსებს ~/.cargo/bin/prx-ში.

ყველა არასავალდებულო ფუნქციის ჩართვით ინსტალაციისთვის (Matrix E2EE, WhatsApp Web და ა.შ.):

cargo install openprx --all-features

ფუნქციების ფლაგები

PRX იყენებს Cargo-ს ფუნქციების ფლაგებს არასავალდებულო არხების მხარდაჭერისთვის:

ფუნქცია	აღწერა
channel-matrix	Matrix არხი E2E დაშიფვრის მხარდაჭერით
whatsapp-web	WhatsApp Web მრავალმოწყობილობიანი არხი
default	ყველა სტაბილური არხი ჩართულია

მეთოდი 3: წყაროდან აგება

დეველოპმენტისთვის ან უახლესი გამოუქვეყნებელი კოდის გასაშვებად:

# კლონირება რეპოზიტორიიდან
git clone https://github.com/openprx/prx.git
cd prx

# რელიზის ბინარის აგება
cargo build --release

# ბინარი მდებარეობს target/release/prx
./target/release/prx --version

ყველა ფუნქციით აგებისთვის:

cargo build --release --all-features

ლოკალურად აგებული ბინარის Cargo-ს bin დირექტორიაში ინსტალაციისთვის:

cargo install --path .

სადეველოპმენტო აგება

დეველოპმენტის დროს უფრო სწრაფი იტერაციისთვის გამოიყენეთ debug აგება:

cargo build
./target/debug/prx --version

WARNING

Debug აგებები მნიშვნელოვნად ნელია გაშვების დროს. ყოველთვის გამოიყენეთ --release წარმოებისთვის ან ბენჩმარქინგისთვის.

მეთოდი 4: Docker

გაუშვით PRX კონტეინერის სახით ლოკალური ინსტალაციის გარეშე:

docker pull ghcr.io/openprx/prx:latest

გაშვება მიმაგრებული კონფიგურაციის დირექტორიით:

docker run -d \
  --name prx \
  -v ~/.config/openprx:/home/prx/.config/openprx \
  -p 3120:3120 \
  ghcr.io/openprx/prx:latest \
  daemon

ან გამოიყენეთ Docker Compose:

# docker-compose.yml
services:
  prx:
    image: ghcr.io/openprx/prx:latest
    restart: unless-stopped
    ports:
      - "3120:3120"
    volumes:
      - ./config:/home/prx/.config/openprx
      - ./data:/home/prx/.local/share/openprx
    command: daemon

TIP

Docker-ში გაშვებისას დააყენეთ თქვენი LLM API გასაღებები გარემოს ცვლადების მეშვეობით ან მიამაგრეთ კონფიგურაციის ფაილი. იხილეთ კონფიგურაცია დეტალებისთვის.

ინსტალაციის შემოწმება

ინსტალაციის შემდეგ დარწმუნდით, რომ PRX მუშაობს:

prx --version

მოსალოდნელი გამოსავალი:

prx 0.3.0

გაუშვით ჯანმრთელობის შემოწმება:

prx doctor

ეს ამოწმებს თქვენს Rust ინსტრუმენტარიუმს (თუ დაინსტალირებულია), სისტემის დამოკიდებულებებს, კონფიგურაციის ფაილის ვალიდურობას და LLM პროვაიდერებთან ქსელის კონექტივობას.

პლატფორმის შენიშვნები

Linux

PRX მუშაობს ნებისმიერ თანამედროვე Linux დისტრიბუციაზე (ბირთვი 4.18+). ბინარი სტატიკურადაა მიბმული rustls-ით TLS-ისთვის, ამიტომ OpenSSL-ის ინსტალაცია საჭირო არ არის.

სენდბოქსის ფუნქციებისთვის შეიძლება დაგჭირდეთ დამატებითი პაკეტები:

# Firejail სენდბოქსის ბექენდი
sudo apt install firejail

# Bubblewrap სენდბოქსის ბექენდი
sudo apt install bubblewrap

# Docker სენდბოქსის ბექენდი (მოითხოვს Docker დემონს)
sudo apt install docker.io

macOS

PRX ნატიურად მუშაობს როგორც Apple Silicon (aarch64), ისე Intel (x86_64) Mac-ებზე. iMessage არხი ხელმისაწვდომია მხოლოდ macOS-ზე.

წყაროდან აგებისას დარწმუნდით, რომ გაქვთ Xcode Command Line Tools:

xcode-select --install

Windows (WSL2)

PRX მხარდაჭერილია Windows-ზე WSL2-ის მეშვეობით. დააინსტალირეთ Linux დისტრიბუცია (რეკომენდებულია Ubuntu) და მიჰყევით Linux-ის ინსტრუქციებს თქვენს WSL2 გარემოში.

# PowerShell-იდან (WSL2-ის ინსტალაცია Ubuntu-ით)
wsl --install -d Ubuntu

შემდეგ WSL2-ის შიგნით:

curl -fsSL https://openprx.dev/install.sh | bash

WARNING

ნატიური Windows-ის მხარდაჭერა ამჟამად არ არის ხელმისაწვდომი. WSL2 უზრუნველყოფს ნატიურთან ახლოს Linux-ის წარმადობას და არის რეკომენდებული მიდგომა.

დეინსტალაცია

PRX-ის წასაშლელად:

# თუ დაინსტალირებულია ინსტალაციის სკრიპტით
rm ~/.local/bin/prx

# თუ დაინსტალირებულია Cargo-ით
cargo uninstall openprx

# კონფიგურაციისა და მონაცემების წაშლა (არასავალდებულო)
rm -rf ~/.config/openprx
rm -rf ~/.local/share/openprx

შემდეგი ნაბიჯები

• სწრაფი დაწყება -- გაუშვით PRX 5 წუთში
• ონბორდინგის ოსტატი -- დააკონფიგურირეთ თქვენი LLM პროვაიდერი
• კონფიგურაცია -- სრული კონფიგურაციის მითითება