Skip to main content

​
AI-Powered Features

Vega AI leverages Google Gemini AI to provide intelligent insights and automated document generation throughout your job search journey.

Smart Job Matching

Get AI-powered compatibility scores (0-100) for each job based on your profile, with detailed analysis of strengths, weaknesses, and actionable feedback.

Cover Letter Generation

Generate personalized, professional cover letters tailored to each job posting and your unique background in seconds.

CV Generation

Create job-specific CVs that highlight relevant experience and skills, optimized for each application.

CV Parsing

Upload your existing CV and let AI automatically extract and populate your profile with work experience, education, and skills.

​
Job Match Analysis

The AI match analysis provides comprehensive insights: 
// Example match analysis structure from internal/job/services_ai.go
type JobMatchAnalysis struct {
    JobID      int       // Job being analyzed
    UserID     int       // User profile reference
    MatchScore int       // 0-100 compatibility score
    Strengths  []string  // Your competitive advantages
    Weaknesses []string  // Areas needing improvement
    Highlights []string  // Key selling points to emphasize
    Feedback   string    // Detailed actionable advice
    AnalyzedAt time.Time // Analysis timestamp
}
Experience-Aware Analysis: For candidates with 2+ years of experience, the AI automatically emphasizes work history over education, ensuring relevant evaluation criteria.

​
Document Generation

Generate professional documents optimized for each application:
  • Cover Letters: Personalized letters that connect your experience to job requirements
  • Tailored CVs: Job-specific resumes highlighting relevant skills and achievements
  • Profile Integration: Documents include your contact information, work history, education, and certifications
  • Context-Aware: AI considers your career summary and additional context for accurate representation

​
Job Management

Application Tracking

Track all job applications with customizable statuses: Applied, Screening, Interview, Offer, Rejected, Withdrawn.

Job Details

Store comprehensive job information including title, company, description, location, salary range, and required skills.

Company Database

Shared reference database for company information to maintain consistency across job postings.

Match History

View historical match analysis results to track how your profile alignment changes over time.

​
Job Capture Workflow

1

Discover Opportunities

Browse jobs on LinkedIn or any job board.
2

One-Click Capture

Use the browser extension to capture job details with a single click.
3

Automatic Organization

Jobs are automatically added to your tracking system with all relevant details.
4

AI Analysis

Optionally analyze job compatibility immediately after capture.

​
Profile Management

Comprehensive Profile

Maintain detailed professional information including personal details, career summary, industry, and context.

Work Experience

Track your employment history with company, title, dates, location, and detailed descriptions.

Education

Record degrees, institutions, fields of study, and dates for all your educational background.

Skills

List technical and soft skills that the AI uses for job matching and document generation.

Certifications

Include professional certifications with issuing organization, dates, and credential IDs.

Experience Calculation

Automatic calculation of total years of experience with overlap handling for concurrent roles.

​
Profile Validation

For AI operations, Vega AI ensures your profile contains sufficient information: 
// Validation requirements from internal/job/services_ai.go:510
// Required for AI features:
// - First name OR last name
// - Career summary OR work experience OR education
// - For work experience: detailed title and company information
AI features require a complete profile with at least your name and career information (summary, experience, or education).

​
Browser Extension

The Vega AI Job Capture browser extension streamlines job discovery and tracking.

​
Extension Features

  • LinkedIn Integration: Capture jobs directly from LinkedIn job postings
  • One-Click Capture: Extract job title, company, description, and requirements automatically
  • API Authentication: Secure connection to your Vega AI instance using JWT tokens
  • Multi-Platform: Works with both cloud and self-hosted deployments

​
Installation

1

Download Extension

Get the latest release from GitHub Releases.
2

Extract Files

Unzip the downloaded file to a folder on your computer.
3

Load in Chrome

Navigate to chrome://extensions/, enable Developer mode, and click “Load unpacked”.
4

Configure

Connect the extension to your Vega AI instance with your API credentials.

​
Security & Privacy

Multi-Tenant Isolation

Row-level security ensures complete data isolation between users with automatic user_id filtering in all queries.

Authentication

JWT-based sessions with configurable expiration. Supports username/password and Google OAuth authentication.

GDPR-Compliant Logging

Privacy-aware logging that never records PII. Uses anonymous user references and hashed identifiers.

Secure Deployment

CSRF protection, security headers, and Docker secrets support for production environments.

​
Authentication Methods

  1. Username/Password: Default authentication for self-hosted deployments
    • Default credentials: admin / VegaAdmin (change immediately after first login)
    • JWT tokens with configurable expiration (60 min access, 168 hours refresh)
  2. Google OAuth: Available in cloud mode
    • No passwords stored in database
    • Secure third-party authentication
    • Automatic profile creation

​
Data Privacy

  • Self-Hosted: All job and profile data stays on your infrastructure
  • AI Processing: Only job descriptions and profile summaries sent to Gemini API
  • No Third-Party Storage: Your data is never stored by external services

​
Quota System

For cloud deployments, Vega AI includes a fair usage quota system.

​
Quota Types

AI Analysis Quota

10 analyses per month in cloud mode. Unlimited re-analysis of previously analyzed jobs.

Job Tracking

Unlimited job tracking and management for all users.

Self-Hosted Mode

No quotas - unlimited AI features when you provide your own Gemini API key.

Quota Reporting

Real-time quota status available via API endpoint /api/jobs/quota.

​
Quota Implementation

From internal/quota/unified_service.go, the quota system:
  • Tracks first-time job analyses against monthly limits
  • Allows unlimited re-analysis of existing jobs
  • Gracefully handles quota exceeded scenarios
  • Provides detailed quota status (used, limit, remaining, reset date)
Quota resets occur monthly. Self-hosted deployments bypass all quota checks when CLOUD_MODE=false.

​
Configuration & Deployment

Docker Deployment

Single-command deployment with Docker. Supports AMD64 and ARM64 (Apple Silicon) architectures.

Docker Compose

Simplified configuration management with compose files for persistent data and environment variables.

Docker Swarm

Production-ready orchestration with Docker Swarm, including secrets management.

Environment Config

Flexible configuration via environment variables or Docker secrets (_FILE suffix support).

​
Key Configuration Options

# Core settings
TOKEN_SECRET=your-jwt-secret           # Required for authentication
GEMINI_API_KEY=your-api-key            # Required for AI features

# Database
DB_CONNECTION_STRING=/app/data/vega.db?_journal_mode=WAL

# Cloud mode settings
CLOUD_MODE=true                        # Enable multi-tenant + quotas
GOOGLE_CLIENT_ID=your-client-id        # For Google OAuth
GOOGLE_CLIENT_SECRET=your-secret       # For Google OAuth

​
Performance Features

SQLite WAL Mode

Write-Ahead Logging for improved concurrency and crash recovery.

Badger Caching

Embedded cache with user-scoped keys for fast data access and automatic invalidation.

Efficient Queries

Composite indexes on (user_id, field) for optimized multi-tenant queries.

Graceful Shutdown

Proper resource cleanup on termination with configurable timeout.

​
API & Integration

Vega AI provides REST API endpoints for programmatic access.

​
Available Endpoints

# Jobs API
POST   /api/jobs           # Create job (browser extension)
GET    /api/jobs/quota     # Check quota status

# Authentication API  
POST   /api/auth/login     # Username/password login
POST   /api/auth/google    # Exchange Google token
POST   /api/auth/refresh   # Refresh access token

# System
GET    /health             # Health check
See the API Reference for detailed endpoint documentation.

​
Next Steps

Quickstart

Deploy Vega AI in minutes.

Browser Extension

Install the job capture extension.

API Reference

Integrate with the REST API.

Build docs developers (and LLMs) love

Get started for freeTalk to us