vit-cli

VIT Chennai in your terminal. Attendance, timetable, grades, CGPA — one command away.

📖 Full command reference → COMMANDS.md — every command, option, and example.

Install

pip install vit-cli

Quick Start

# Login (one-time — session saved to ~/.vit-cli/)
vit login --username YOUR_VTOP_USERNAME

# Check attendance (color-coded)
vit attendance

# Alert if any subject below 75%
vit attendance --alert 75

# Today's timetable
vit timetable --today

# Full week timetable
vit timetable

# Grades for current semester
vit grades

# CGPA summary
vit cgpa

# Internal marks with assessment breakdown
vit marks

# Exam schedule
vit exams

# Show saved session info
vit whoami

# Logout
vit logout

Features

• One-time login — session persisted to ~/.vit-cli/session.json
• Color-coded attendance — green (>=75%), yellow (70-74%), red (<70%)
• Attendance alerts — --alert 75 flags low attendance
• Today or full week — vit timetable --today or vit timetable
• Grade display — color-coded (S=green, F=red)
• CGPA panel — styled summary with credit progress
• Internal marks — assessment breakdown per course
• Exam schedule — slot, date, time, venue, seat number
• No browser needed — works in any terminal

Requirements

• Python 3.10+
• A VIT Chennai VTOP account

Development

git clone https://github.com/daksh1403/vit-cli.git
cd vit-cli
pip install -e ".[dev]"
pytest

How It Works

vit-cli logs into VTOP directly using httpx, solves the captcha using a numpy-based ML model (no external API calls), and parses the HTML responses with BeautifulSoup. Session cookies are saved locally so you only login once.

License

MIT