Skip to content

STREAMLIT_WEBAPP.md

Latest commit

 

History

History
182 lines (136 loc) · 5.93 KB

STREAMLIT_WEBAPP.md

File metadata and controls

182 lines (136 loc) · 5.93 KB
Raw

🌐 Streamlit Web Application

Professional Web Interface for LinkedIn Sourcing Agent

Your LinkedIn Sourcing Agent now includes a beautiful, interactive web interface built with Streamlit! Perfect for demos, non-technical users, and hackathon presentations.

🚀 Quick Start

Option 1: One-Click Launch (Windows)

# Double-click or run in terminal
start_webapp.bat

Option 2: One-Click Launch (Mac/Linux)

# Make executable and run
chmod +x start_webapp.sh
./start_webapp.sh

Option 3: Manual Start

# Install Streamlit (if not already installed)
pip install streamlit plotly

# Launch the web app
streamlit run streamlit_app.py

Access the app at: http://localhost:8501

🎯 Web App Features

🔍 Search Tab

  • Interactive Job Description Input: Multi-line text area for detailed job requirements
  • Smart Search Configuration: Keywords, location, experience level, industry filters
  • Real-time Search: Live candidate discovery with progress indicators
  • One-click Search: Simplified interface for quick candidate sourcing

📊 Results Tab

  • Visual Metrics Dashboard: Candidate count, average scores, distribution charts
  • Interactive Score Distribution: Plotly charts showing candidate quality spread
  • Detailed Candidate Cards: Expandable cards with profiles, scores, and LinkedIn links
  • Gauge Score Visualization: Beautiful circular gauges for fit scores
  • Multiple Export Options: Excel, JSON, and clipboard-ready summaries

💌 Outreach Tab

  • Candidate Selection: Dropdown to choose specific candidates
  • Message Type Templates: Professional, job opportunity, networking options
  • AI-Powered Generation: Personalized outreach messages using your AI setup
  • Custom Notes Integration: Add specific points to mention in outreach
  • Copy-Ready Messages: One-click copying for immediate use

📈 Analytics Tab

  • Search History Tracking: Timeline of all searches performed
  • Trend Analysis: Visual trends in search results over time
  • Company Distribution: Bar charts showing top candidate companies
  • Location Insights: Pie charts of candidate geographic distribution
  • Performance Metrics: System usage statistics and efficiency metrics

🎨 Professional Design

Modern UI Elements

  • Gradient Headers: Eye-catching blue gradient design
  • Responsive Layout: Works on desktop, tablet, and mobile
  • Interactive Charts: Plotly visualizations for data insights
  • Professional Cards: Clean candidate presentation cards
  • Color-coded Scores: Intuitive red-yellow-green scoring system

User Experience

  • Sidebar Configuration: Easy API key and settings management
  • Session State Management: Persistent data across tab navigation
  • Error Handling: Graceful error messages and recovery
  • Loading Indicators: Clear progress feedback during operations
  • Help Text: Contextual tooltips and guidance

🔧 Configuration

API Keys (Sidebar)

  • Google Gemini API: For AI-powered outreach generation
  • OpenAI API: Alternative AI provider option
  • LinkedIn API: Optional (uses demo data if not provided)

Search Settings

  • Max Candidates: Slider from 5-50 candidates
  • Generate Outreach: Toggle for message generation
  • Auto-export Excel: Automatic Excel file creation

📱 Demo Mode

The web app works perfectly without any API keys for hackathon demonstrations:

  • Realistic Demo Data: Generated candidates with proper LinkedIn profiles
  • Full Functionality: All features work with simulated data
  • Professional Presentation: Perfect for judges and stakeholders
  • No Setup Required: Works immediately after installation

🎯 Perfect for Hackathons

Judge-Friendly Features

  • Visual Appeal: Professional, polished interface
  • Interactive Demo: Judges can try all features live
  • Clear Value Proposition: Obvious benefits for recruitment
  • Technical Depth: Shows sophisticated backend integration

Presentation Ready

  • Full-Screen Mode: Clean presentation interface
  • Real-time Updates: Dynamic content updates
  • Export Demonstrations: Show Excel/JSON export capabilities
  • Analytics Visualization: Impressive charts and metrics

🚀 Deployment Options

Local Development

streamlit run streamlit_app.py

Streamlit Cloud (Free)

  1. Push code to GitHub
  2. Connect to Streamlit Cloud
  3. Deploy with one click
  4. Get shareable public URL

Docker Deployment

FROM python:3.9-slim
COPY . /app
WORKDIR /app
RUN pip install -r requirements.txt
EXPOSE 8501
CMD ["streamlit", "run", "streamlit_app.py"]

💡 Usage Tips

For Demonstrations

  1. Start with Demo Search: Use "Python Developer" + "San Francisco"
  2. Show Score Breakdown: Click on candidate cards to show detailed scoring
  3. Generate Messages: Demonstrate AI outreach generation
  4. Export Results: Show Excel download functionality
  5. Analytics View: Display search trends and insights

For Production Use

  1. Add API Keys: Configure real LinkedIn and AI APIs
  2. Customize Scoring: Adjust scoring rubrics in sidebar
  3. Export Integration: Use Excel/Google Sheets features
  4. Track History: Monitor search patterns in analytics

🎨 Screenshots

The web app includes:

  • Beautiful dashboards with gradient headers
  • Interactive charts using Plotly
  • Professional candidate cards with LinkedIn integration
  • Real-time score gauges for visual impact
  • Responsive design that works on all devices

Perfect for the Synapse AI Hackathon! 🏆

Your LinkedIn Sourcing Agent now has a professional web interface that showcases all features in an intuitive, judge-friendly format. Start the web app and experience the future of AI-powered recruitment!