scalattice-agent

KO | EN

gitlite — search

#html #docker #react-native #agent #linux #terminal #graphql #http #agents #redis

scalattice-agent

(★ 9)

Open-source GPU operator agent for the Scalattice inference network (Rust).

파일 탐색기

ZIP 다운로드

- - ci.yml
  - release.yml
- AGENT_PROTOCOL.md
- macos-signing.md
- - entitlements.plist
  - Info.plist
- - detect-compute-devices.ps1
  - launch-background-delayed.vbs
  - launch-background.vbs
  - launch-tray-interactive.vbs
  - launch-tray.vbs
  - open-tray-debug.cmd
  - README.md
  - resolve-nvidia-driver.ps1
  - scalattice-agent.iss
  - scalattice-run.cmd
  - scalattice.ico
- build-release.ps1
- build-release.sh
- build-windows-installer.ps1
- bundle-release-libs.sh
- bundle-release-windows.ps1
- check-windows-runner.sh
- ci-gh-release-upload.ps1
- ci-prepare-release.sh
- ci-update-smoke.py
- diagnose-windows.ps1
- ensure-artifact-signing-tools.ps1
- install-windows-runner.cmd
- install-windows-runner.ps1
- package-macos.sh
- prepare-windows-ci.ps1
- prune-cargo-target.sh
- README.md
- release.sh
- reset-releases.sh
- run-ci-update-smoke.ps1
- setup-windows-build.cmd
- setup-windows-build.ps1
- sign-artifact-windows.ps1
- sign-macos.sh
- sync-cargo-version.ps1
- windows-build-common.ps1
- - mod.rs
  - python.rs
  - worker.py
- - embedded.rs
  - ggml_devices.rs
  - mod.rs
  - model_cache.rs
  - progress.rs
  - prompt.rs
  - split.rs
  - vision.rs
- - capacity.rs
  - download.rs
  - gguf_arch.rs
  - gguf_check.rs
  - health.rs
  - mod.rs
  - storage.rs
  - sync.rs
  - vram_plan.rs
- - linux.rs
  - macos.rs
  - mod.rs
  - uninstall_notify.rs
  - windows.rs
- - host.rs
  - ipc.rs
  - mod.rs
  - placement.rs
  - worker.rs
- - mod.rs
  - notify.rs
  - ui.rs
- - cloud.rs
  - linux.rs
  - mod.rs
  - version.rs
  - windows.rs
- agent.rs
- cloud_log.rs
- compute_pool.rs
- config.rs
- inference.rs
- logging.rs
- main.rs
- paths.rs
- protocol.rs
- runtime.rs
- settings.rs
- specs.rs
- state.rs
- vram_lifecycle.rs
.gitignore
build.rs
Cargo.lock
Cargo.toml
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE
README.md
SECURITY.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Open-source GPU agent for the [Scalattice](https://scalattice.com) inference network,
a product of [Robottik Ltd](https://robottik.co.uk).

Install it on a machine with a GPU, connect with a provider token, and Scalattice Cloud can route inference jobs to you.

## Install

### Linux

```bash
curl -fsSL https://scalattice.cloud/install/agent | sh -s -- --token slt_provider_YOUR_TOKEN
source ~/.config/scalattice/agent.env
scalattice-agent status
```

Full agent logs go to `~/.local/share/scalattice/agent.log` (always verbose; rotated at 8 MiB with one backup). `scalattice-agent logs` tails that file.

### Windows

Download and run **[ScalatticeAgentSetup-x86_64.exe](https://github.com/scalattice/scalattice-agent/releases/latest/download/ScalatticeAgentSetup-x86_64.exe)** from [GitHub Releases](https://github.com/scalattice/scalattice-agent/releases) (or use **Download Windows installer** on the Providers dashboard).

1. Run the setup wizard (approve SmartScreen if prompted)
2. Paste your `slt_provider_…` token when asked
3. Finish — PATH is configured and the background agent starts

Setup guide: https://scalattice.cloud/install/agent-setup

The agent registers a **boot** scheduled task (runs as SYSTEM before sign-in) plus logon Startup/Task rails. Use the notification area icon for status, token changes, and live logs. Full detail is written to `%LOCALAPPDATA%\Scalattice\logs\agent.log` (rotated at 8 MiB, one backup). The tray Live log can show a Simplified view; the file itself is always verbose.

### macOS (Apple Silicon)

Release builds are **arm64 + Metal only**. Intel Macs are not supported.

Download and open **[ScalatticeAgentSetup-aarch64.dmg](https://github.com/scalattice/scalattice-agent/releases/latest/download/ScalatticeAgentSetup-aarch64.dmg)** (or use **Download macOS installer** on the Providers dashboard).

1. Open the disk image and run **Scalattice Agent** (approve Gatekeeper if prompted)
2. Paste your `slt_provider_…` token in the control panel
3. Finish — the agent stays in the menu bar

Setup guide: https://scalattice.cloud/install/agent-setup?os=macos

The binary is compiled and signed on GitHub’s `macos-14` runners. See [docs/macos-signing.md](docs/macos-signing.md).

Background mode uses a LaunchAgent. Stay signed in (or enable auto-login) so launchd keeps the agent running. The menu bar app is the same control panel as Windows (status, token, logs).

### Uninstall

On Windows, use Settings → Apps. The wizard asks whether to delete downloaded models; logs and settings are always removed.

On Linux and macOS:

```bash
scalattice-agent uninstall
```

That prompts to keep or delete model weights, then asks you to type `yes`. Use `--yes` to skip the confirmation (models are kept) and `--purge` to delete models too.

Releases are self-contained binaries (plus bundled runtime libraries where allowed). You can also build from source with Rust/Cargo.

### Hardware support

Release builds include **CUDA** (NVIDIA) and **Vulkan** (AMD/Intel/ARM) on Linux and Windows, and **Metal** on Apple Silicon Macs.

| Hardware | What the host needs |
|----------|---------------------|
| NVIDIA GTX/RTX | NVIDIA driver installed (`nvidia-smi` works) |
| AMD / Intel GPU | Vendor Vulkan ICD (AMD Adrenalin / Intel graphics driver). **ROCm is not required.** Discrete AMD/Intel are detected on Linux (`lspci`) and Windows (Win32 video controllers) and run through Vulkan when enabled in the Providers dashboard. |
| Apple Silicon | macOS 14+, M1 or later. Unified memory is advertised as GPU VRAM (minus OS headroom). **Intel Macs are not supported.** |
| CPU only | Nothing extra — the agent connects; inference uses the CPU backend |

When both NVIDIA and AMD/Intel are enabled, the agent prefers **CUDA**. AMD/Intel-only pools use the same load cascade as NVIDIA (`gpu-full` → offload → CPU). Check agent logs for `Vulkan pool: pinning ggml backend device(s)`.

Do **not** redistribute `vulkan-1.dll` — providers get it from their GPU driver. Build machines need the [Vulkan SDK](https://vulkan.lunarg.com/) (for `glslc` only).

NVIDIA’s `libcuda.so` / `nvcuda.dll` cannot be redistributed. Machines without a GPU driver still run the agent; GPU inference activates when the driver is present.

## Quick start

1. Sign in at [scalattice.cloud](https://scalattice.cloud) → **Providers**
2. Register as a provider and create an **agent token** (`slt_provider_…`)
3. On your GPU machine:

```bash
curl -fsSL https://scalattice.cloud/install/agent | sh -s -- --token slt_provider_…
source ~/.config/scalattice/agent.env
scalattice-agent status
```

The install script saves your token and starts the background agent. To change the token later:

```bash
scalattice-agent set-token --token slt_provider_…
```

## Environment

| Variable | Description |
|----------|-------------|
| `SCALATTICE_AGENT_TOKEN` | Provider agent token (`slt_provider_…`) |

The agent connects to Scalattice Cloud using the built-in endpoint. Region, models, and schedule are managed in the Providers dashboard — not via local flags.

## Protocol

See [docs/AGENT_PROTOCOL.md](docs/AGENT_PROTOCOL.md).

## Build from source

```bash
# x86_64 Linux (NVIDIA + AMD/Intel Vulkan)
cargo build --release --features gpu

# aarch64 Linux (NVIDIA + ARM Vulkan) — build natively on ARM
cargo build --release --no-default-features --features arm-gpu
```

```powershell
# x86_64 Windows (NVIDIA CUDA + AMD/Intel Vulkan) — run in PowerShell
# Requires Vulkan SDK on the build machine (glslc). Providers do not need the SDK.
.\scripts\build-release.ps1
```

CI release binaries: **CUDA + Vulkan** on x86_64/aarch64 Linux and x86_64 Windows.

## Community

| Document | Purpose |
|----------|---------|
| [CONTRIBUTING.md](CONTRIBUTING.md) | How to report issues and when we accept changes |
| [SECURITY.md](SECURITY.md) | Responsible disclosure for security issues |
| [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) | Community standards |

## License

MIT. See [LICENSE](LICENSE).

scalattice-agent

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README