QUICK_START_GUIDE.md

🚀 IQKiller - Quick Start Guide

Get IQKiller running in 5 minutes

⚡ Instant Deploy (Recommended)

Use Live Demo

🔗 https://huggingface.co/spaces/Akarrahe/IQKillerv2

• No setup required
• Fully functional
• Production ready

🛠️ Local Setup (5 minutes)

1. Clone & Setup

git clone https://huggingface.co/spaces/Akarrahe/IQKillerv2
cd IQKillerv2
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

2. Get API Keys

# Required: OpenAI API Key
# Get from: https://platform.openai.com/api-keys
export OPENAI_API_KEY="sk-proj-your-key-here"

# Optional but recommended: Anthropic API Key
# Get from: https://console.anthropic.com/
export ANTHROPIC_API_KEY="sk-ant-your-key-here"

# Optional: Firecrawl API Key (for better web scraping)
# Get from: https://firecrawl.dev/
export FIRECRAWL_API_KEY="fc-your-key-here"

3. Launch

python gradio_app.py
# Open: http://localhost:7860

📋 How to Use

Input Methods

1. Resume: Upload PDF or paste text
2. Job: Paste URL or job description
3. Click: "Full Interview Guide" or "Quick Analysis"

What You Get

• ✅ 30-60 second AI analysis
• ✅ Personalized interview questions
• ✅ Skills gap analysis
• ✅ Salary negotiation practice
• ✅ Action items & recommendations

🔧 Environment Variables

Create .env file:

OPENAI_API_KEY=your_openai_key_here
ANTHROPIC_API_KEY=your_anthropic_key_here  
FIRECRAWL_API_KEY=your_firecrawl_key_here
DEVELOPMENT_MODE=false
AUTH_ENABLED=false

🐳 Docker (Alternative)

docker build -t iqkiller .
docker run -p 7860:7860 \
  -e OPENAI_API_KEY=your_key \
  -e ANTHROPIC_API_KEY=your_key \
  iqkiller

📚 Full Documentation

• Complete Guide: PROJECT_DOCUMENTATION.md
• Features: INTERVIEW_GUIDE_README.md
• Overview: README.md

🆘 Quick Troubleshooting

API Key Issues

echo $OPENAI_API_KEY  # Should show your key
export OPENAI_API_KEY="sk-proj-..."  # Set if missing

Dependencies

pip install --upgrade -r requirements.txt

Port Conflicts

# Use different port
python gradio_app.py --server-port 7861

---

⚡ That's it! You're ready to transform your interview prep with AI.