alprina quickstart

Interactive tutorial to get started with Alprina in minutes.

Synopsis


alprina quickstart

Description

The alprina quickstart command launches an interactive, beginner-friendly tutorial that teaches you how to use Alprina effectively. Perfect for first-time users who want to understand Alprina’s capabilities through hands-on practice.

This guided tutorial will:

Walk you through your first security scan
Explain scan results in plain English
Show you how to interpret findings
Demonstrate fixing vulnerabilities
Teach best practices for secure coding

No prior security knowledge required!

Usage

Simply run:


alprina quickstart

The tutorial will guide you step-by-step through the process.

What You’ll Learn

1. Running Your First Scan

Learn how to scan local files and understand what Alprina is checking.


✨ Welcome to Alprina Quickstart!
 
We'll run your first security scan together.
Creating a sample vulnerable application... ✓
 
Let's scan it:
  $ alprina scan ./sample-app

2. Understanding Scan Results

See real vulnerability findings and learn what they mean.


📊 Scan Results:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Found 3 vulnerabilities:

1. HIGH - SQL Injection
   📍 Location: database.py:42
   💡 What this means: An attacker could manipulate
      your database queries and steal data.

3. Fixing Vulnerabilities

Learn how to use alprina fix to remediate issues.


Let's fix this SQL injection:
  $ alprina fix ./sample-app --id VULN-001

Would you like to apply this fix? [y/N]: y
✓ Fixed! Your code is now secure.

4. Best Practices

Get tips on securing your code during development.

Who Should Use Quickstart?

Perfect for:

🆕 First-time users - Never used Alprina before
🎓 Developers learning security - Want to understand common vulnerabilities
🚀 Quick onboarding - Need to get productive fast
📚 Visual learners - Prefer hands-on tutorials

Tutorial Duration

The quickstart tutorial takes approximately 5-10 minutes to complete.

You can:

⏸️ Pause at any time (Ctrl+C)
🔁 Restart anytime by running alprina quickstart again
⏩ Skip sections if you’re already familiar

Interactive Features

Guided Explanations

Every step includes clear explanations of what’s happening:


🔍 Now we're scanning for security issues...

Alprina is checking your code for:
  • SQL injection vulnerabilities
  • Hardcoded secrets and API keys
  • Weak cryptography
  • Common security misconfigurations

This usually takes 5-10 seconds...

Real-time Feedback

See results as Alprina analyzes code:


✓ Scanned 15 files
✓ Found 3 vulnerabilities
✓ Generated fix recommendations

Hands-on Practice

Actually run commands and see real results (in a safe sandbox):


💻 Try it yourself:

Run this command:
  $ alprina scan ./sample-app --profile code-audit

Press Enter when ready...

After Quickstart

Once you complete the tutorial, you’ll know how to:

✅ Scan your own projects
✅ Interpret security findings
✅ Fix vulnerabilities with AI
✅ Generate security reports
✅ Integrate Alprina into your workflow

Next Steps

After completing quickstart:

Scan Your Own Code
```
alprina scan ./your-project
```
Read the Full Guide Visit Getting Started for in-depth documentation.
Try Advanced Features
Join the Community
- GitHub Discussions
- Report Issues

Example Session

Here’s what a typical quickstart session looks like:


$ alprina quickstart
 
✨ Welcome to Alprina Quickstart!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
This tutorial will teach you:
  1. How to scan code for vulnerabilities
  2. How to interpret security findings
  3. How to fix issues with AI
  4. Best practices for secure coding
 
Time required: ~5-10 minutes
 
Ready to start? [Y/n]: y
 
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
STEP 1: Your First Security Scan
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
Creating a sample vulnerable application...
✓ Created sample-app/ with 3 files
 
Let's scan it for security issues:
  $ alprina scan ./sample-app
 
Running scan... ✓
 
📊 Found 3 vulnerabilities:
  • 1 HIGH severity
  • 2 MEDIUM severity
 
[Tutorial continues...]

Troubleshooting

Tutorial won’t start

Ensure you have internet connectivity for the first run.

Want to skip the tutorial?

If you’re already familiar with Alprina, jump straight to:

alprina scan - Start scanning
alprina auth login - Authenticate
Quick Start Guide - Written documentation

Tutorial interrupted?

Just run alprina quickstart again to restart. Your progress isn’t saved between sessions.

Quick Start Guide - Written version of this tutorial
First Scan Tutorial - Detailed scanning guide
CLI Commands Overview - All available commands
Security Agents - Learn about Alprina’s AI agents

Feedback

Help us improve the tutorial! If you have suggestions:

🎓 Ready to learn? Run alprina quickstart now!