Home / Docs / Getting Started

Getting Started

Get Falcn running and scan your first project in under 60 seconds.

Prerequisites

  • Linux, macOS, or Windows with WSL
  • Go 1.21+ (for building from source) or Docker

Installation

The fastest way to install Falcn:

curl -sSL https://falcn.io/install | sh

Or with Docker:

docker pull vanali/falcn:latest

Your First Scan

Navigate to any project with dependencies and run:

falcn scan .

Falcn will automatically detect your package manager (npm, pip, go, etc.) and scan all dependencies.

Example Output

🦅 FALCN v2.0.0 - Supply Chain Security Scanner
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[✓] Detected: package.json (npm)
[✓] Scanning 47 dependencies...
[✓] Running RUNT, DIRT, GTR analysis...

✅ No threats detected
Scan completed in 94ms | 0 threats | 47 safe packages

Enable AI Explanations

For human-readable threat explanations, enable Ollama integration:

export FALCN_LLM_ENABLED=true
export FALCN_LLM_PROVIDER=ollama
falcn scan .

🎉 You’re all set!

You’ve successfully installed Falcn and run your first scan. Continue to the Installation Guide for more options.