Skip to content

Commit b12c9d3

Browse files
authored
Revise README for VisaIQ project details and features
Updated project description, features, and deployment instructions. Enhanced clarity on the system's capabilities and future enhancements.
1 parent ce60c9f commit b12c9d3

1 file changed

Lines changed: 86 additions & 39 deletions

File tree

README.md

Lines changed: 86 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,65 @@
1-
# VisaIQ — Visa Processing Time Estimator
1+
# VisaIQ — AI-Powered Visa Processing Intelligence System
22

3-
A machine learning powered web app that predicts visa processing times based on historical data, with AI-generated insights powered by Google Gemini.
3+
### Built by Akshat Raj | Founder of OnePersonAI
44

5-
Built for **Infosys Springboard Internship — Milestone 4**
5+
VisaIQ is an advanced machine learning system designed to predict visa processing timelines with high accuracy while delivering AI-powered insights for smarter decision-making.
6+
7+
This project combines predictive modeling with real-time AI analysis to transform how individuals and organizations understand visa workflows.
8+
9+
---
10+
11+
## Live Application
12+
13+
https://visapredictor-upltsgqphxttgzdnzheset.streamlit.app/
614

715
---
816

9-
## Features
17+
## Overview
1018

11-
- Upload historical visa data (CSV) to train a custom ML model
12-
- Predict processing time for any country and visa type
13-
- Confidence score and min/max range for each prediction
14-
- AI-powered insights using Google Gemini for actionable advice
15-
- Clean dark UI with real-time results
19+
VisaIQ is not just a prediction tool — it is an intelligent system that analyzes historical visa data to generate actionable insights. It leverages machine learning models along with AI reasoning to provide both numerical predictions and contextual recommendations.
1620

1721
---
1822

19-
## Tech Stack
23+
## Key Features
2024

21-
- **Frontend** — Streamlit
22-
- **ML Model** — Scikit-learn (Random Forest / Gradient Boosting)
23-
- **AI Insights** — Google Gemini 1.5 Flash
24-
- **Data** — Pandas, NumPy
25+
* Predict visa processing time using trained machine learning models
26+
* Generate confidence scores and processing ranges
27+
* AI-powered insights using Google Gemini
28+
* Support for custom dataset uploads (CSV-based training)
29+
* Clean and responsive user interface
30+
* Real-time results with minimal latency
2531

2632
---
2733

28-
## CSV Format
34+
## Problem Statement
35+
36+
Visa applicants often face uncertainty regarding processing timelines, leading to poor planning and decision-making. Existing tools lack predictive intelligence and contextual understanding.
37+
38+
VisaIQ addresses this gap by providing data-driven predictions combined with AI-generated insights.
39+
40+
---
41+
42+
## Technical Architecture
43+
44+
* Frontend: Streamlit (Interactive UI)
45+
* Machine Learning: Scikit-learn (Random Forest, Gradient Boosting)
46+
* AI Layer: Google Gemini 1.5 Flash
47+
* Data Processing: Pandas, NumPy
48+
* Deployment: Streamlit Cloud
49+
50+
---
51+
52+
## How It Works
53+
54+
1. Upload historical visa data (CSV format)
55+
2. Train a machine learning model dynamically
56+
3. Input country and visa type
57+
4. Get predicted processing time
58+
5. Receive AI-generated insights for better decision-making
59+
60+
---
2961

30-
Your training data must have these 4 columns:
62+
## Sample Dataset Format
3163

3264
```csv
3365
country,visa_type,application_date,decision_date
@@ -41,49 +73,64 @@ UK,Tourist,2024-06-15,2024-06-30
4173
## Local Setup
4274

4375
```bash
44-
# 1. Clone the repo
4576
git clone https://github.com/AkshatRaj00/visapredictor.git
4677
cd visapredictor
4778

48-
# 2. Create virtual environment
4979
python -m venv venv
5080
venv\Scripts\activate
5181

52-
# 3. Install dependencies
5382
pip install -r requirements.txt
5483

55-
# 4. Add your Gemini API key in app.py
84+
# Add Gemini API Key in app.py
5685
GEMINI_API_KEY = "your_key_here"
5786

58-
# 5. Run the app
5987
streamlit run app.py
6088
```
6189

6290
---
6391

64-
## Streamlit Cloud Deploy
92+
## Deployment
6593

66-
1. Push code to GitHub
67-
2. Go to [share.streamlit.io](https://share.streamlit.io)
68-
3. Connect repo and set main file as `app.py`
69-
4. Add secret in app settings:
70-
```toml
71-
GEMINI_API_KEY = "your_gemini_key"
72-
```
94+
* Hosted on Streamlit Cloud
95+
* Easily deployable on any cloud platform
7396

7497
---
7598

76-
## Project Structure
99+
## Impact & Use Cases
77100

78-
```
79-
visapredictor/
80-
├── app.py # Main Streamlit app
81-
├── predict.py # Prediction logic
82-
├── train.py # Model training
83-
├── requirements.txt # Dependencies
84-
└── README.md
85-
```
101+
* Students planning international education
102+
* Professionals applying for work visas
103+
* Immigration consultants and agencies
104+
* Data-driven travel planning
86105

87106
---
88107

89-
Made by Akshat Raj  |  Infosys Springboard 2026
108+
## Future Enhancements
109+
110+
* Real-time API integration with embassy data
111+
* Deep learning models for higher accuracy
112+
* Multi-language support
113+
* Mobile application version
114+
* Dashboard analytics for agencies
115+
116+
---
117+
118+
## About the Developer
119+
120+
Akshat Raj is an AI Engineer and Founder of OnePersonAI, focused on building intelligent, human-centric systems that integrate machine learning with real-world applications.
121+
122+
---
123+
124+
## Connect
125+
126+
Portfolio: https://onepersonai.in
127+
GitHub: https://github.com/AkshatRaj00
128+
129+
---
130+
131+
## Keywords
132+
133+
Akshat Raj AI Engineer, Visa Prediction System, Machine Learning Project, AI India, OnePersonAI, Streamlit AI App, Visa Processing Predictor
134+
<img width="1919" height="900" alt="Screenshot 2026-04-04 004618" src="https://github.com/user-attachments/assets/c9f998fd-7b61-4a86-872e-99532a073509" />
135+
<img width="1918" height="904" alt="Screenshot 2026-04-04 004645" src="https://github.com/user-attachments/assets/81eb0922-c02f-4e2b-b2eb-90ca2aef8588" />
136+

0 commit comments

Comments
 (0)