Track Slots in Real-Time, and Never Miss an Appointment Again.
Built for Automation and Scale.
VisaSlotAI is a robust, distributed, and high-performance automated system designed to continuously monitor, parse, and alert on visa appointment slot openings. Built with a unified full-stack architecture, it includes a modern "Neon Cyber" dashboard for real-time monitoring.
- π΅οΈ Stealth Automation: Utilizes Playwright with Stealth plugins to mitigate standard headless browser detections.
- β‘ Distributed Task Processing: Powered by Celery and Redis to handle concurrent scraping targets efficiently without blocking the main event loop.
- π¦ Unified Pip Package: The entire system operates as a globally installable CLI tool (
visa-api,visa-worker,visa-beat). - ποΈ Neon Cyber Dashboard: A React-built, internally served Single Page Application (SPA) offering beautiful widgets, real-time analytics, and manual scan triggers.
- π Timezone-Aware Logging: Accurate DB event creation locked to
Europe/Istanbul(or customizable) regardless of server location. - π Notification Ready: Built-in architecture designed to be extensible for Telegram, Email, and SMS alerts.
The project operates under a seamless Monolith-like execution but maintains Microservice-like separation of concerns internally.
- Core API: FastAPI (High-performance async Python web framework).
- Task Queue: Celery (Workers and Beat scheduler).
- Message Broker: Redis.
- Database: PostgreSQL (Accessed via
pg8000&SQLAlchemyORM). - Browser Automation:
playwright+playwright-stealth.
- Framework: React (TypeScript).
- Styling: Tailwind CSS v4.
- Icons: Lucide-React.
- Integration: Compiled as static files (
npm run build) and injected directly into FastAPI'sStaticFilesrouter. No separate Node.js server required in production!
The built-in Cyber Dashboard (accessible at http://localhost:8000 when the API is running) features dynamic widgets:
- System Statistics Widget: Real-time display of Total Scans, Active Targets, and System Errors (Bot blocked metrics).
- Targets Manager: View currently configured visa endpoints (Country, Visa Type, Target URL).
- Live Log Viewer: Scrollable, real-time fetching of PostgreSQL scan logs detailing exactly when slots are found, with timezone-accurate timestamps.
- Manual Trigger Control: "Scan Now" buttons to forcefully dispatch Celery worker tasks via the API bypassing the Cron schedule.
VisaSlotAI is engineered for Extreme Cost Efficiency, designed to bypass the exorbitant fees of traditional Scraping-as-a-Service platforms. By leveraging scalable open-source tools and containerization, your operational costs drop to near-zero.
| βοΈ Service Component | π Traditional SaaS APIs | β VisaSlotAI (Self-Hosted) | π Free-Tier Alternative |
|---|---|---|---|
| Web Scraping / Anti-Bot | π΄ $50 - $200+ |
π’ $0.00 (Local Playwright) |
Playwright Local |
| Database (PostgreSQL) | π΄ $15 - $50 |
π’ $0.00 (Docker Local) |
Supabase/Neon (Free Tier) |
| Task Queue (Redis) | π΄ $10 - $30 |
π’ $0.00 (Docker Local) |
Upstash (Free Tier) |
| Hosting (Compute) | π΄ $20+ |
π’ $4.00 - $7.00 (VPS) |
Render/Fly.io (Limited) |
| Proxies (Optional) | π΄ $20 - $100 |
π’ $2.00 - $5.00 (Custom) |
Free/Shared Proxies |
| Notifications | π΄ $10+ |
π’ $0.00 (Telegram/SMTP) |
Telegram Bots |
| π TOTAL ESTIMATED | π₯ $125 - $400+ / mo |
π© $4.00 - $12.00 / mo |
π© $0.00 / mo |
Tip
- π» Hardware: Your personal computer (Windows/Mac/Linux).
- π οΈ Setup: Run
visa-api,visa-worker, andvisa-beatvia terminal. PostgreSQL and Redis via Local Docker. - πΈ Cost:
$0.00 - π― Best for: Part-time monitoring while you work.
Note
- βοΈ Provider: Hetzner (CX11 - β¬3.79/mo) or DigitalOcean ($4/mo Basic Droplet).
- βοΈ Specs: 1 vCPU, 2GB RAM (Minimum required for Headless Chromium).
- π οΈ Setup: Ubuntu 22.04 LTS, Docker Compose for DB/Redis, Systemd or PM2 for CLI.
- πΈ Cost:
~$4.00 / month - π― Best for: 24/7 continuous monitoring of 5-10 visa targets.
Important
- π Provider: AWS, GCP, or Azure.
- βοΈ Specs: Dedicated API Server (ECS/EC2), Managed DBs, Dedicated Redis, Auto-scaling Celery Workers.
- π‘οΈ Proxy Pool: Rotating Residential IP Proxies.
- πΈ Cost:
$50.00+ / month - π― Best for: Tracking hundreds of targets across dozens of countries concurrently.
VisaSlotAI is built with a decoupled architecture, allowing you to easily snap-in additional modules:
- Telegram Alerts: Create a free Telegram Bot via BotFather. Inject your
TELEGRAM_BOT_TOKENandCHAT_IDinto.envto receive instant messages the millisecond a slot opens. - Email Notifications: Standard Python
smtplibcan be configured to use Gmail App Passwords for free email alerts. - Discord Webhooks: Easily push JSON payloads to a Discord channel.
- Custom Proxy Rotation: Connect the Playwright engine to proxy services like Smartproxy or IPRoyal by simply updating the proxy arguments in the base scraper class.
Modern visa appointment websites employ various bot protections. VisaSlotAI currently uses a foundational layer to avoid basic detection:
- Playwright Stealth: Injects specific scripts to mask headless browser signatures (e.g., overriding
navigator.webdriver). - Configurable Intervals: Configurable Celery Beat intervals ensure the system doesn't spam endpoints, blending in with standard human traffic.
(Note: Advanced WAFs like strict Cloudflare or Datadome configurations may still require additional custom proxy combinations or CAPTCHA solving integrations in future updates.)
We are constantly working to improve the resilience and capabilities of VisaSlotAI. Here is what we are planning for upcoming releases:
- 𧩠Advanced WAF Bypass: Integration with robust solvers (e.g., FlareSolverr) and deeper Datadome evasion techniques.
- π€ Smart CAPTCHA Solving: Hook-ins for 3rd-party CAPTCHA solving services (2Captcha, AntiCaptcha) or local AI vision models natively.
- π±οΈ Humanized Interactions: Implementation of Bezier-curve mouse movements, randomized typing speeds, and natural scrolling algorithms.
- πͺ Session Persistence: Advanced profile management to cache and re-use cookies, avoiding repetitive logins and "new device" security flags.
- π Smart Proxy Pooling: Built-in architecture to automatically rotate residential/mobile proxies upon rate-limit detection or bans.
- π± Expanded Notifications: Direct integrations for SMS (Twilio) and WhatsApp alerts alongside Telegram and Email.
VisaSlotAI supports both Local Development and One-Click Cloud Deployments.
VisaSlotAI is built with Infrastructure-as-Code (render.yaml) to support free, automated cloud scaling.
- Sign up on Render.com
- Go to
New->Blueprint - Connect your GitHub repository.
- Render will automatically parse the
render.yamlfile and deploy the App, Postgres DB, Redis, and Background Workers seamlessly.
Deploy the entire integrated system using the production Docker Compose manifest:
git clone https://github.com/CodeByPinar/VisaSlotAI.git
cd VisaSlotAI
docker-compose -f docker-compose.prod.yml up -d- Prerequisites: Python 3.10+, Node.js v18+, Docker.
- Infrastructure:
cd docker
docker-compose up -dInstall the project as an editable pip package. This will expose the custom CLI commands globally in your environment.
cd backend
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install -e .
playwright install # Download the headless browser binariescd frontend
npm install
npm run build
# The build output is automatically configured to be read by the backendBecause VisaSlotAI is packaged via setup.py, you can manage the entire ecosystem directly from your terminal using simple commands.
Make sure your virtual environment is activated.
Boots the FastAPI server on port 8000 and serves the React Cyber Dashboard.
visa-apiπ Visit http://localhost:8000 in your browser.
Initializes the Celery worker that executes the Playwright stealth scripts in the background.
visa-workerInitializes Celery Beat, which automatically pushes scan tasks to the worker based on your defined intervals.
visa-beatTargets are managed via a JSON configuration file located at: backend/app/config/scan_targets.json
Example structure:
[
{
"id": "trk_schengen_01",
"country": "Germany",
"visa_type": "Schengen - Tourist",
"url": "https://example-visa-provider.com/appointments",
"check_interval_minutes": 15
}
]This software is provided for educational and personal use only. Automated accessing of appointment booking systems may violate the Terms of Service of specific providers (e.g., VFS Global, iDATA, TLScontact). The developers assume no liability for IP bans, account suspensions, or legal repercussions resulting from the use of this software. Please configure reasonable check_interval_minutes to avoid overloading targeted servers.
Built with β€οΈ by AI.