langchain-ictexam
LangChain tools for ICTExam, the AI-powered exam authoring, delivery and auto-grading platform from ICT Innovations. Give an agent the ability to turn a question paper into a structured exam, publish it, and read the marks and per-question analysis back out.
Install
pip install langchain-ictexam
Quick start
from langchain_ictexam import ICTExamToolkit
toolkit = ICTExamToolkit.from_credentials(
base_url="https://app.ictlms.net", # your ICTExam site
email="teacher@example.com",
password="...",
)
tools = toolkit.get_tools()
Behind the usual reverse proxy the API lives under /api (the default). If you
talk straight to the backend port, pass api_prefix="".
Plug the tools into any LangChain agent:
from langchain.agents import create_react_agent # or your agent of choice
agent = create_react_agent(model, tools)
agent.invoke({"messages": "Parse ./midterm.pdf, publish it, then show the gradebook."})
Tools
| Tool | What it does |
|---|---|
list_exams |
List exam papers (id, title, status, class, subject) |
get_exam |
One paper's settings, share links and questions |
list_classes |
Classes (course groups) |
list_subjects |
Subjects, each tied to a class |
get_gradebook |
Per-exam totals and student marks |
get_item_analysis |
Per-question difficulty, p-value and average mark |
parse_question_paper |
Upload a PDF/DOCX and AI-extract the questions |
publish_exam |
Publish a paper; returns student and teacher share URLs |
unpublish_exam |
Set a paper back to draft |
Authentication
Sign in with any teacher or admin account. The client holds the session cookie and echoes the CSRF token on writes for you — nothing else to configure.
About
ICTExam grades objective, fill-in-the-blank and short-answer questions deterministically; with an AI key configured on the server it also does rubric-graded essay and image/vision marking. It ships with a native Moodle activity module (LTI 1.3, grade passback and roster sync). Learn more at ictlms.net and ictinnovations.com.
MIT licensed.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file langchain_ictexam-0.1.0.tar.gz.
File metadata
- Download URL: langchain_ictexam-0.1.0.tar.gz
- Upload date:
- Size: 7.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3a312b1eb57324ca3ac91d4ef64049b33894531e6a4f23b5e9604c83a084ff91
|
|
| MD5 |
789b335592861af0a2ace3dbf2f06abc
|
|
| BLAKE2b-256 |
cca886bc3f89c8dd08dc308097ae6fbbb1f3c961d08ed769f26a9e7ee05666d9
|
Provenance
The following attestation bundles were made for langchain_ictexam-0.1.0.tar.gz:
Publisher:
publish.yml on ictinnovations/langchain-ictexam
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
langchain_ictexam-0.1.0.tar.gz -
Subject digest:
3a312b1eb57324ca3ac91d4ef64049b33894531e6a4f23b5e9604c83a084ff91 - Sigstore transparency entry: 2673002280
- Sigstore integration time:
-
Permalink:
ictinnovations/langchain-ictexam@4c62930676b1524ab9c91ab09cf1994366587ee9 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/ictinnovations
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@4c62930676b1524ab9c91ab09cf1994366587ee9 -
Trigger Event:
release
-
Statement type:
File details
Details for the file langchain_ictexam-0.1.0-py3-none-any.whl.
File metadata
- Download URL: langchain_ictexam-0.1.0-py3-none-any.whl
- Upload date:
- Size: 8.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ee205d2ae62d3714dedb20af6e7d8abe6bcbfeddb7b55a4e395879f20d979198
|
|
| MD5 |
7879102d153fc41eacd24d63ce27fcb8
|
|
| BLAKE2b-256 |
1303adb892cd30a052a34722214fe69c3ae15c939763fcc69d567d6c201f5569
|
Provenance
The following attestation bundles were made for langchain_ictexam-0.1.0-py3-none-any.whl:
Publisher:
publish.yml on ictinnovations/langchain-ictexam
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
langchain_ictexam-0.1.0-py3-none-any.whl -
Subject digest:
ee205d2ae62d3714dedb20af6e7d8abe6bcbfeddb7b55a4e395879f20d979198 - Sigstore transparency entry: 2673002323
- Sigstore integration time:
-
Permalink:
ictinnovations/langchain-ictexam@4c62930676b1524ab9c91ab09cf1994366587ee9 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/ictinnovations
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@4c62930676b1524ab9c91ab09cf1994366587ee9 -
Trigger Event:
release
-
Statement type: