{"id":35179859,"url":"https://github.com/viraj-sh/uniclare-client","last_synced_at":"2026-04-06T04:32:31.494Z","repository":{"id":322429984,"uuid":"1071500263","full_name":"viraj-sh/uniclare-client","owner":"viraj-sh","description":"View end-semester marks and detailed performance data that are hidden on the Uniclare App or Student Portal.","archived":false,"fork":false,"pushed_at":"2026-01-27T11:46:58.000Z","size":1331,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-27T23:36:54.162Z","etag":null,"topics":["dypatil","fastapi","mydy","restapi","studentportal","uniclare"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/viraj-sh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-07T12:39:43.000Z","updated_at":"2026-01-27T16:44:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/viraj-sh/uniclare-client","commit_stats":null,"previous_names":["viraj-sh/uniclare-client"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/viraj-sh/uniclare-client","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/viraj-sh%2Funiclare-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/viraj-sh%2Funiclare-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/viraj-sh%2Funiclare-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/viraj-sh%2Funiclare-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/viraj-sh","download_url":"https://codeload.github.com/viraj-sh/uniclare-client/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/viraj-sh%2Funiclare-client/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31460102,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T21:22:52.476Z","status":"online","status_checked_at":"2026-04-06T02:00:07.287Z","response_time":112,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dypatil","fastapi","mydy","restapi","studentportal","uniclare"],"created_at":"2025-12-29T00:54:39.074Z","updated_at":"2026-04-06T04:32:31.489Z","avatar_url":"https://github.com/viraj-sh.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Unofficial Uniclare Client\n\nAn unofficial [Uniclare](https://play.google.com/store/apps/details?id=com.uniclarepro\u0026hl=en_IN\u0026pli=1) / [Student Uni Portal](https://studentportal.universitysolutions.in/) client built to reveal full ESE marks and every hidden result field the official portal doesn’t display. Includes [Frontend](https://github.com/viraj-sh/uniclare-client/wiki/Frontend-Documentation), [MCP Server](https://github.com/viraj-sh/uniclare-client/wiki/MCP-Documentation), [API](https://github.com/viraj-sh/uniclare-client/wiki/API-Documentation), developed for personal educational purposes and not affiliated with Uniclare or Student Portal.\n\n\u003ca href=\"https://github.com/viraj-sh/uniclare-client/releases/latest\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/v/release/viraj-sh/uniclare-client?label=Latest%20Release\u0026color=green\u0026style=flat-square\u0026cacheSeconds=3600\" alt=\"Release\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://hub.docker.com/r/virajsh/uniclare-client\"\u003e\n  \u003cimg src=\"https://img.shields.io/docker/v/virajsh/uniclare-client?label=Docker\u0026color=blue\u0026sort=semver\u0026style=flat-square\" alt=\"Docker\"/\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/viraj-sh/uniclare-client/wiki\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/docs-wiki-red?style=flat-square\" alt=\"Wiki\"/\u003e\n\u003c/a\u003e\n\n\u003c/div\u003e\n\n---\n\n### What Makes This Client Better than the Official [Uniclare App](https://play.google.com/store/apps/details?id=com.uniclarepro\u0026hl=en_IN\u0026pli=1) or [Student Uni Portal](https://studentportal.universitysolutions.in/)\n\n- **End-semester marks**: Shows full ESE marks for every subject, which the official client hides even though the backend provides them.\n- **Complete marks breakdown**: Displays all components returned by the API — end marks, IA marks, viva/practical marks, and totals.\n- **Additional result fields**: Reveals extra data like percentage, credits, grade points, credit points, and more that the official portal doesn’t show.\n- **MCP server support**: Allows integration with LLMs for automation, summarization, or custom result analysis.\n\n---\n\n## Installation \u0026 Usage\n\nThe client can be run in several ways. For detailed steps, see the **[Getting Started](https://github.com/viraj-sh/uniclare-client/wiki/Getting-Started)** wiki page.\n\nOption 1. **[Prebuilt Releases](https://github.com/viraj-sh/uniclare-client/wiki/Getting-Started#prebuilt-releases)** – Download and run the latest release for your platform:\n\n   [![Windows (.exe)](https://img.shields.io/badge/Windows_\\(.exe\\)-x64-blue?style=flat-square)](https://github.com/viraj-sh/uniclare-client/releases/download/v1.1.3/uniclare-client-v1.1.3-win-x64.exe)\n   [![Linux (.tar.gz)](https://img.shields.io/badge/Linux-x86__64-orange?style=flat-square)](https://github.com/viraj-sh/uniclare-client/releases/download/v1.1.3/uniclare-client-v1.1.3-linux-x86__64)\n   [![macOS (.zip)](https://img.shields.io/badge/macOS-arm64-lightgrey?style=flat-square)](https://github.com/viraj-sh/uniclare-client/releases/download/v1.1.3/uniclare-client-v1.1.3-macos-arm64)\n\nOption 2. **[One-Click Deployment](https://github.com/viraj-sh/uniclare-client/wiki/Getting-Started#one-click-deployment-render) (Render)** – Deploy the client instantly in the cloud:\n\n   [![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/viraj-sh/uniclare-client)\n\nOption 3. **[Run from Source](https://github.com/viraj-sh/uniclare-client/wiki/Getting-Started#running-from-source)** – Clone the repository and run the client directly in development mode.\n\n  - For developers who want to modify the client.\n\n\n    ```bash\n    git clone https://github.com/viraj-sh/uniclare-client\n    cd uniclare-client\n\n    python -m venv venv\n    venv\\Scripts\\activate   # Windows\n    source venv/bin/activate   # macOS/Linux\n\n    pip install --upgrade pip\n    pip install -r requirements/base.txt\n\n    python app.py\n    ```\n\nOption 4. **[Build from Source](https://github.com/viraj-sh/uniclare-client/wiki/Getting-Started#building-from-source)** – For developers or contributors: clone the repo, install dependencies, and run locally.\n\nOption 5. **[Docker](https://github.com/viraj-sh/uniclare-client/wiki/Getting-Started#docker-deployment)** – Run the client in a consistent containerized environment.\n\n\u003e For complete instructions, platform-specific steps, and Docker usage, see the **[Getting Started wiki](https://github.com/viraj-sh/uniclare-client/wiki/Getting-Started)**.\n\n---\n### Available Services\n\nOnce the client is running, these endpoints are accessible (host may vary):\n\n* **[Frontend](https://github.com/viraj-sh/uniclare-client/wiki/Frontend-Documentation)** [[http://localhost:8000/](http://localhost:8000/)] : Static interface to interact with the API.\n* **[MCP Server](https://github.com/viraj-sh/uniclare-client/wiki/MCP-Documentation)** [[http://localhost:8000/mcp](http://localhost:8000/mcp)] : Endpoint (`/mcp`) compatible with Model Context Protocol (MCP) clients like LLM Clients or LangChain bots.\n* **[API](https://github.com/viraj-sh/uniclare-client/wiki/API-Documentation)** [[http://localhost:8000/api](http://127.0.0.1:8000/api)] : FastAPI backend for authentication, semesters, subjects, documents, and attendance.\n\n  * **Interactive Docs:** [[http://localhost:8000/docs](http://127.0.0.1:8000/docs)] : API testing Swagger UI for developers.\n\n---\n\n## MCP Usage\n\n\u003e For full instructions on configuring the MCP server, check out the **[MCP Documentation](https://github.com/viraj-sh/uniclare-client/wiki/MCP-Documentation)**.\n\u003c!--\n| Demo |\n| :------------: |\n| \u003cimg src=\"https://raw.githubusercontent.com/viraj-sh/uniclare-client/refs/heads/main/.github/assets/mcp_usage.gif\" width=\"800\"/\u003e | --\u003e\n\n## Preview\n\n| Detailed Result                                      | Login                                           |\n| :-------------------------------------------- | :-------------------------------------------- |\n| \u003cimg src=\"https://raw.githubusercontent.com/viraj-sh/uniclare-client/refs/heads/main/.github/assets/preview_result_detailed.png\" width=\"500\" height=\"300\"/\u003e | \u003cimg src=\"https://raw.githubusercontent.com/viraj-sh/uniclare-client/refs/heads/main/.github/assets/preview_login.png\" width=\"500\" height=\"300\"/\u003e |\n\n| Result List                                    | Profile                                         |\n| :------------------------------------------- | :-------------------------------------------- |\n| \u003cimg src=\"https://raw.githubusercontent.com/viraj-sh/uniclare-client/refs/heads/main/.github/assets/preview_results.png\" width=\"500\" height=\"300\"/\u003e | \u003cimg src=\"https://raw.githubusercontent.com/viraj-sh/uniclare-client/refs/heads/main/.github/assets/preview_profile.png\" width=\"500\" height=\"300\"/\u003e |\n\n\n---\n## Disclaimer\n\nThis project is **unofficial** and intended for **personal and educational use only**.\nUniclare, Student Portal or the college has **no affiliation or endorsement** with this project.\n\nUse responsibly. The author is **not liable** for misuse, data loss, or any violations of institutional policies.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fviraj-sh%2Funiclare-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fviraj-sh%2Funiclare-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fviraj-sh%2Funiclare-client/lists"}