Skip to main content

🧠 AI Splitter

AI-Based CO-Wise Mark Splitter with Excel Export for Assessments

By Sathish Ramanujam • https://professor-sathish.github.io/


📌 Overview

AI Splitter is a simple and powerful tool for generating Course Outcome (CO)–wise mark split-ups for assessments. It uses AI-powered logic to automatically distribute marks based on your inputs and exports clean, formatted Excel split-up sheets instantly.

This tool is built for:

  • Faculty members
  • Assessment coordinators
  • Examination cell teams
  • Academic departments

The entire app runs in a Streamlit UI and exposes a single command:

ai-splitter

which opens the app immediately.


🚀 Features

  • ✔ Automatic CO-wise mark splitting
  • ✔ Instant Excel export (openpyxl)
  • ✔ Clean Streamlit UI
  • ✔ Works for all assessments (CIA, Assignment, Model, etc.)
  • ✔ Lightweight & fast
  • ✔ No configuration needed
  • ✔ 100% offline after installation

📥 Installation

1. Install via pip

pip install ai-splitter

2. Run the app

ai-splitter

This launches your browser with the full Streamlit UI.


▶️ Usage

Once the app launches:

  1. Enter Assessment Name
  2. Enter Total Marks
  3. Enter Required CO Split Breakdown
  4. Click Generate
  5. Download the Excel output

Simple, fast, accurate.


🖥️ Launching the App Manually (Optional)

If you want to run the app manually:

streamlit run ai_splitter/app.py

OR using Python:

python -m streamlit run ai_splitter/app.py

⚠️ Windows Users — Important (PATH Fix)

If you installed Python from the Microsoft Store, the ai-splitter command may not work immediately.

You may see:

'ai-splitter' is not recognized as an internal or external command

This happens because Microsoft Store Python does not add the Scripts folder to PATH.

✔ Fix

Add this folder to your PATH:

%LocalAppData%\Packages\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\LocalCache\local-packages\Python311\Scripts

Steps:

  1. Press Win + R → type sysdm.cpl → Enter
  2. Go to Advanced → Environment Variables
  3. Under User variables, select Path
  4. Click Edit → New
  5. Paste:
%LocalAppData%\Packages\PythonSoftwareFoundation.Python.3.11_qbz5n2kfra8p0\LocalCache\local-packages\Python311\Scripts
  1. Save → close CMD → open new CMD
  2. Run:
ai-splitter

Install Python from:

https://www.python.org/downloads/

Enable:

  • Add Python to PATH
  • Install for all users

🧩 CLI Command Reference

Launch the application:

ai-splitter

Show help:

ai-splitter --help

📦 Version

Current version: 0.1.2


👨‍💻 Developer

AI Splitter
Created by Sathish Ramanujam
Website: https://professor-sathish.github.io/
Department of Information Technology, KGiSL Institute of Technology


🔖 License

MIT License
Free for academic and educational use.


❤️ Acknowledgements

  • Built with Python 3.9+
  • UI powered by Streamlit
  • Excel generation using openpyxl
  • Developed with love for the academic community

Metadata

Release files for ai-splitter 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ai-splitter 0.1.3
File Size Uploaded Provenance Actions
ai_splitter-0.1.3.tar.gz 12.6 kB Without provenance Details for ai_splitter-0.1.3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ai-splitter 0.1.3
File Interpreter ABI Platform Actions
ai_splitter-0.1.3-py3-none-any.whl Python 3 none any Details for ai_splitter-0.1.3-py3-none-any.whl

Total release size: 24.5 kB

Release files / ai_splitter-0.1.3.tar.gz

Download URL ai_splitter-0.1.3.tar.gz
Size 12.6 kB
Tags Source
SHA-256 checksum
How to use checksums
f9fd1a2043815135bf63217191a478288528bc5a4592cbe6c8bba6b321ce6820
BLAKE2b-256 checksum
How to use checksums
aa1757b87a4aabc2a79436732a735604f83056adf8d798457a5ed51634f3bce2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Release files / ai_splitter-0.1.3-py3-none-any.whl

Download URL ai_splitter-0.1.3-py3-none-any.whl
Size 11.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
21167b1c4640487f1fe1ac462fce238d24bad33c553ce88bbf0cd3e0e8ccfb1c
BLAKE2b-256 checksum
How to use checksums
06adfd8fe10150fa692053bb1976076115f5c3ed4e5c81854ec36eab15bd5bfc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.7

Security for ai-splitter 0.1.3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.3 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page