AKTU CS Notes

August 13, 2026 · View on GitHub

AI-generated Computer Science engineering study notes for all 8 semesters of the AKTU syllabus.

What it is

Free, browsable markdown study notes covering the official AKTU (Dr. A.P.J. Abdul Kalam Technical University) Computer Science & Engineering curriculum, semesters 1–8. Every topic in the syllabus was turned into a detailed set of notes using LLMs, then organized by semester and subject so students can revise without hunting through scattered PDFs.

It exists because AKTU notes are hard to find in one clean, searchable place — this repo consolidates them and publishes them as a static site.

Live site: https://aktu-cs-notes.oriz.in
Repo: https://github.com/chirag127/aktu-cs
Pages landing: served from docs/ via GitHub Pages

⭐ If this is useful, please star the repo — it helps other AKTU students find it.

⚠️ Disclaimer: These notes are AI-generated study aids, not official AKTU material. They may contain errors or omissions — always verify against the official syllabus and your course material before relying on them for exams.

How it works

flowchart LR
    A[Official AKTU syllabus] --> B[Topic list per subject]
    B --> C[Python generators in scripts/]
    C -->|LLM API| D[Markdown notes]
    D --> E[remove_empty_notes.py<br/>strip stubs]
    E --> F[allnotes/cs/&lt;sem&gt;/]
    F --> G[docs/ static site]
    G -->|deploy-pages.yml| H[GitHub Pages<br/>aktu-cs-notes.oriz.in]
    QP[Question-paper scrapers<br/>qp_*.py] --> R[Releases archive]

Semester / Subject Index

Notes are organized by semester under allnotes/cs/:

Semester	Folder	Subjects
1st	`allnotes/cs/1/`	Engineering Physics, Chemistry, Mathematics I & II, Electrical, Electronics, Programming, Mechanical, Environment, Soft Skills + labs
2nd	`allnotes/cs/2/`	Data Structures, Computer Organization, Discrete Structures, OS, Theory of Automata, Microprocessor, Python, AI
3rd	`allnotes/cs/3/`	DBMS, Compiler Design, DAA, Web Designing, Computer Graphics, Machine Learning, Software Engineering, Computer Networks
4th	`allnotes/cs/4/`	AI, NLP, High Performance Computing, Cryptography, Mobile Computing, IoT, Cloud Computing, Blockchain, Deep Learning
5th	`allnotes/cs/5/`	Compiler Design, DBMS, DAA, Machine Learning, COI, Web Design
6th–8th	`allnotes/cs/6/`…	Generated progressively via `scripts/` and added over time

How Notes Were Generated

Python scripts in scripts/ used LLM APIs to generate detailed markdown notes for every topic in the official AKTU syllabus. API keys are read from environment variables — see .env.example.

cp .env.example .env
# Add your API key(s) to .env
pip install openai tiktoken requests
python scripts/generate_notes_threaded.py

Script	Purpose
`generate_notes_threaded.py`	Multi-threaded note generation
`generate_notes_async.py`	Async generation via Completions
`main_generator.py`	Single-key generator
`batch_processor.py`	Batch processing with fallback
`bulk_input.py`	Bulk input handler
`post_processor.py`	Post-process and clean generated notes
`poe_generator.py`	POE-based generation
`remove_empty_notes.py`	Remove empty/stub markdown files
`sem5_generate_cd_notes.py`	Sem-5 Compiler Design note generator
`sem5_generate_wd_notes.py`	Sem-5 Web Design note generator
`sem5_download_helper.py` / `sem5_search_helper.py`	Sem-5 PDF download + syllabus search helpers
`qp_abes.py` / `qp_aktuonline.py` / `qp_function.py`	Question-paper scrapers

Prune any empty or stub notes across the tree:

python remove_empty_notes.py

Question Papers

Past AKTU exam question papers (162 PDFs) are distributed as a downloadable archive in Releases to keep the repo lightweight.

Download aktu-question-papers.zip from the latest release and extract into question-papers/.

Source	Subfolder	Contents
ABES	`abes/`	Papers from ABES Engineering College — MP, TAFL, Mathematics
AKTU Online	`aktuonline/`	Papers from aktuonline.com — OS, TAFL, UH subjects
Archive	`archive/`	Archived 3rd-semester papers (COA, DS, DSTL, CSS, TC, SI)

Features

Markdown notes for all 8 semesters of the AKTU CS syllabus, browsable on the web.
Semester → subject → topic organization under allnotes/cs/.
Reproducible generation pipeline (scripts/) — regenerate or extend notes yourself.
Question-paper scrapers and a downloadable paper archive.
Static site auto-deployed to GitHub Pages on every push to main.

Tech stack

Python — note generation, post-processing, and question-paper scrapers (openai, tiktoken, requests).
Markdown — the notes themselves.
Static HTML/CSS (docs/) — the published site.
GitHub Actions — deploy-pages.yml (Pages deploy) and megalinter.yml (linting).

Repo structure

aktu-cs/
├── allnotes/cs/<sem>/        # Notes organized by semester → subject → topic
├── question-papers/          # Extracted question papers (archive in Releases)
├── syllabus/                 # Official AKTU syllabus source
├── scripts/                  # Python note generators + QP scrapers
├── ai-notes-toolkit/         # Reusable notes toolkit (its own site)
├── docs/                     # Static site published to GitHub Pages
├── remove_empty_notes.py     # Utility: strip empty/stub notes
└── .env.example              # Env var template (API keys)

Configuration

Variable	Purpose
`OPENAI_API_KEY_1` … `OPENAI_API_KEY_5`	API keys used by the note-generation scripts (rotated for throughput). Only needed if regenerating notes — browsing the site requires none.

Never commit a real .env — it is gitignored.

Quick start

This is primarily a content repo — the main "usage" is browsing the notes:

Read online at https://aktu-cs-notes.oriz.in, or
Browse allnotes/cs/ directly in the repo.

To regenerate or extend notes locally, see How Notes Were Generated above.

AKTU CS Notes

What it is

How it works

Semester / Subject Index

How Notes Were Generated

Question Papers

Features

Tech stack

Repo structure

Configuration

Quick start

Part of the oriz family

Contributing

Status

Changelog

License

Author