Skip to content

install.md

Latest commit

 

History

History
106 lines (74 loc) · 2.99 KB

install.md

File metadata and controls

106 lines (74 loc) · 2.99 KB

Installing Semfora Engine

Prerequisites

  • Rust toolchain 1.70+ (edition 2021) — install via rustup
  • Git (to clone the repo)

Platform-specific dependencies

  • Linux: build-essential (gcc, make) — usually pre-installed
  • macOS: Xcode Command Line Tools (xcode-select --install)
  • Windows: MSVC build tools via Visual Studio Build Tools

From GitHub Releases (recommended)

Download a prebuilt binary from the Releases page.

Each release includes statically-linked binaries for:

Platform Asset
Linux x86_64 semfora-engine-x86_64-unknown-linux-musl.tar.gz
Linux aarch64 semfora-engine-aarch64-unknown-linux-musl.tar.gz
macOS x86_64 semfora-engine-x86_64-apple-darwin.tar.gz
macOS Apple Silicon semfora-engine-aarch64-apple-darwin.tar.gz
Windows x86_64 semfora-engine-x86_64-pc-windows-msvc.zip 
# Example: Linux x86_64
curl -LO https://github.com/Semfora-AI/semfora-engine/releases/latest/download/semfora-engine-x86_64-unknown-linux-musl.tar.gz
tar xzf semfora-engine-x86_64-unknown-linux-musl.tar.gz
sudo mv semfora-engine /usr/local/bin/

# Verify
semfora-engine --version

Each release also includes a checksums.sha256 file. Verify your download:

sha256sum -c checksums.sha256 --ignore-missing

From Source

Quick install

git clone https://github.com/Semfora-AI/semfora-engine.git
cd semfora-engine
cargo install --path .

This installs semfora-engine to ~/.cargo/bin/ (make sure it's in your PATH).

Build without installing

cargo build --release

Binaries land in target/release/:

  • semfora-engine — main CLI (analysis, indexing, querying, MCP server)
  • semfora-daemon — WebSocket daemon for real-time index updates
  • semfora-benchmark-builder — benchmark tooling
  • semfora-security-compiler — security pattern compiler

With embedded security patterns

cargo build --release --features embedded-patterns

Package Managers (future)

These are planned but not yet available:

  • Homebrew: brew install semfora-engine — coming soon
  • crates.io: cargo install semfora-engine — coming soon
  • AUR: yay -S semfora-engine — coming soon
  • apt/deb: planned

Verification

# Check version
semfora-engine --version

# Run a quick analysis
semfora-engine analyze --help

# Analyze a file
echo 'fn main() { println!("hello"); }' > /tmp/test.rs
semfora-engine analyze /tmp/test.rs

Troubleshooting

cargo build fails with linker errors on Linux: Install build essentials: sudo apt install build-essential

Binary not found after cargo install: Ensure ~/.cargo/bin is in your PATH: export PATH="$HOME/.cargo/bin:$PATH"

Permission denied on macOS: The binary may need to be allowed in System Settings → Privacy & Security after first run.
⚡