Skip to content

View end-semester marks and detailed performance data that are hidden on the Uniclare App or Student Portal.

Notifications You must be signed in to change notification settings

viraj-sh/uniclare-client

Repository files navigation

Unofficial Uniclare Client

An unofficial Uniclare / Student Uni Portal client built to reveal full ESE marks and every hidden result field the official portal doesn’t display. Includes Frontend, MCP Server, API, developed for personal educational purposes and not affiliated with Uniclare or Student Portal.

Release Docker Wiki

What Makes This Client Better than the Official Uniclare App or Student Uni Portal

  • End-semester marks: Shows full ESE marks for every subject, which the official client hides even though the backend provides them.
  • Complete marks breakdown: Displays all components returned by the API — end marks, IA marks, viva/practical marks, and totals.
  • Additional result fields: Reveals extra data like percentage, credits, grade points, credit points, and more that the official portal doesn’t show.
  • MCP server support: Allows integration with LLMs for automation, summarization, or custom result analysis.

Installation & Usage

The client can be run in several ways. For detailed steps, see the Getting Started wiki page.

Option 1. Prebuilt Releases – Download and run the latest release for your platform:

Windows (.exe) Linux (.tar.gz) macOS (.zip)

Option 2. One-Click Deployment (Render) – Deploy the client instantly in the cloud:

Deploy to Render

Option 3. Run from Source – Clone the repository and run the client directly in development mode.

  • For developers who want to modify the client.

    git clone https://github.com/viraj-sh/uniclare-client
    cd uniclare-client
    
    python -m venv venv
    venv\Scripts\activate   # Windows
    source venv/bin/activate   # macOS/Linux
    
    pip install --upgrade pip
    pip install -r requirements/base.txt
    
    python app.py

Option 4. Build from Source – For developers or contributors: clone the repo, install dependencies, and run locally.

Option 5. Docker – Run the client in a consistent containerized environment.

For complete instructions, platform-specific steps, and Docker usage, see the Getting Started wiki.


Available Services

Once the client is running, these endpoints are accessible (host may vary):


MCP Usage

For full instructions on configuring the MCP server, check out the MCP Documentation.

Preview

Detailed Result Login
Result List Profile

Disclaimer

This project is unofficial and intended for personal and educational use only. Uniclare, Student Portal or the college has no affiliation or endorsement with this project.

Use responsibly. The author is not liable for misuse, data loss, or any violations of institutional policies.

About

View end-semester marks and detailed performance data that are hidden on the Uniclare App or Student Portal.

Topics

Resources

Contributing

Stars

Watchers

Forks

Contributors 2

  •  
  •