Quickstart Guide

Get started with Alprina in under 5 minutes. This guide will help you run your first security scan and understand the basics.

What is Alprina?

Alprina is an AI-powered security platform with 20+ specialized security agents that provides enterprise-grade security scanning without the enterprise complexity. It’s designed for modern developers who need fast, comprehensive security analysis.

Key Benefits:

⚡ Fast: Scan in seconds, not weeks
💰 Affordable: $9-29/month vs$ 10k-50k for traditional audits
🤖 AI-Powered: Uses Claude and GPT models for intelligent analysis
🔒 Comprehensive: Covers Web3, API, Mobile, DevOps, and application security

Step 1: Install Alprina

Choose your preferred installation method:

Quick Install (Recommended)

macOS / Linux:


curl -fsSL https://api.alprina.com/install.sh | sh

Or the shorthand version:


curl -fsSL https://api.alprina.com/cli | sh

Windows (PowerShell):


iwr https://api.alprina.com/install.ps1 -useb | iex

Install via pip


pip install alprina-cli

Verify Installation


alprina --version

Step 2: Authenticate

Connect Alprina to your account:


# Login with your API key (get it from dashboard)
alprina auth login --api-key YOUR_API_KEY
 
# Or use OAuth
alprina auth login --provider github
 
# Verify authentication
alprina auth status

Step 3: Run Your First Scan

Quick Code Audit (5 seconds)


# Scan your local code
alprina scan ./src --quick

Full Security Scan


# Comprehensive code audit
alprina scan ./my-project --profile code-audit
 
# API security testing
alprina scan https://api.example.com --profile web-recon --safe-only
 
# Smart contract audit
alprina scan contract.sol --all

Step 4: View Results

Check Scan History


alprina history

Generate Report


# HTML report
alprina report --format html --output security-report.html
 
# PDF report
alprina report --format pdf --output security-report.pdf

Interactive Chat

Ask Alprina’s AI assistant about your findings:


alprina chat

Then ask questions like:

“What are the critical vulnerabilities?”
“How do I fix the SQL injection?”
“Explain the security risk in simple terms”

Common Commands

Command	Purpose	Example
`alprina scan <target>`	Run security scan	`alprina scan ./src`
`alprina chat`	AI security assistant	`alprina chat`
`alprina history`	View past scans	`alprina history`
`alprina report`	Generate report	`alprina report --format html`
`alprina fix`	Get AI-powered fixes	`alprina fix ./app.py`
`alprina recon <target>`	Reconnaissance	`alprina recon api.example.com`

Example Workflows

Workflow 1: Audit Your Web Application


# 1. Run comprehensive scan
alprina scan ./src --profile code-audit
 
# 2. View results in browser
alprina report --format html --output report.html
open report.html
 
# 3. Get AI-powered fixes
alprina fix ./src --severity critical
 
# 4. Ask questions
alprina chat

Workflow 2: Smart Contract Security


# 1. Comprehensive audit
alprina scan MyContract.sol --all \
  --tvl 100000000 \
  --protocol-type lending
 
# 2. Check for MEV vulnerabilities
alprina scan MyContract.sol --mev
 
# 3. Optimize gas costs
alprina scan MyContract.sol --gas
 
# 4. Generate audit report
alprina report --format html --output audit.html

Workflow 3: API Security Testing


# 1. Passive reconnaissance (safe)
alprina recon api.example.com --passive
 
# 2. Active security scan
alprina scan https://api.example.com --profile web-recon
 
# 3. View findings
alprina history --latest
 
# 4. Get remediation advice
alprina chat --load results.json

What’s Next?

Explore Security Agents

Alprina has 20+ specialized agents for different security domains:

Red Team Agent - Offensive security testing
Blue Team Agent - Defensive security analysis
Code Security Agent - SAST/DAST scanning
LLM Security Agent - AI/ML security
Network Analyzer - Infrastructure security

View All Security Agents →

Learn More

CLI Reference - Complete command documentation
Playbooks - Real-world security scenarios
Integrations - Connect Alprina to your workflow
Chat Workflows - Interactive security assistance

Get Help

Troubleshooting - Common issues and solutions
Discord Community - Get help from the team
GitHub Issues - Report bugs

Quick Tips

💡 Use --quick for fast scans during development, then run full scans before deployment

💡 Try alprina chat - it’s like having a security expert on your team

💡 Generate HTML reports to share findings with your team

💡 Use --profile flags to run pre-configured scan recipes

💡 Check alprina history to track your security posture over time

Need Help?

📖 Full Documentation - Complete guides and references
💬 Chat Support - Get help from our community
📧 Email Support - Contact our team
🐛 Report Issues - Found a bug?

Ready to dive deeper? Check out our Playbooks for detailed security workflows and real-world case studies.