PURPOSE · PRODUCT · STEWARDSHIP

Gurbani Updesh

Help people read, listen to, and understand Gurbani, wherever they are in their learning.

The project at a glance

Gurbani Updesh brings a Gurbani audio library, the Sri Guru Granth Sahib Ji reader, and supporting learning experiences into one service. Its public website is the current home; native Apple and Android clients are also maintained. Features in development or test builds should not be assumed available in every released app.

The immediate production priority is an English Katha collection covering all 1,430 Angs. It combines recorded Gurbani recitation with spoken English meanings, retaining the recitation’s prominence and a natural listening pace. Each Ang gets its own properly named and tagged track, published into the existing library after automated checks.

For the listener and reader

  • Browse and search the media library, listen to recordings, and return to saved playback positions.
  • Read Sri Guru Granth Sahib Ji in its familiar page layout; navigate by Ang and listen from a line, with the page following the recitation where alignment is available.
  • Access English meanings and supporting Punjabi interpretation as they become available.
  • Use native reading content offline; audio downloading and caching depend on the app and its settings.
  • Participate in shared reading and review experiences where enabled. Volunteer tools support alignment and quality checking.

For the project owner

Success is a useful, dependable reading and listening service whose content can be checked and improved. Completion counts alone do not establish the accuracy of a meaning or the quality of a listening experience.

The workspace brings project conversations, progress, tasks, spending estimates, quality evidence, and human decisions together. Codex, Claude, and eventually Muse can exchange work while Gurinder retains judgement over funding, sensitive choices, and unresolved content questions.

Browse the library ↗ · Open the reader ↗

Current priorities and decisions

Complete English meanings, build and independently audit the associated audio, publish approved tracks, and resolve exceptions without interrupting the rest of the queue. Gurinder has reported successful listening spot checks; the sample was not specified, so this does not mean every track has been manually reviewed.

The separate source-alignment question on Ang 479 remains a targeted publication hold until resolved with evidence. The workspace’s Human Judgement section carries the current questions. A prior Ang 2 concern was retracted by Gurinder, and republication was approved.

Live progress is available in the workspace.

Finance and capacity

The figures below describe the current operating boundary. They are not an invoice, prepaid account balance, or an assurance that future usage will fit the budget.

AreaWhat is knownWhat needs watching
English narrationApproved cumulative estimated run cap: $150. Live estimate appears in the workspace.The duration-based estimate excludes text-input fees, translation and hosting. Verify actual provider billing separately; a top-up does not automatically raise the run cap.
Translation and agentsClaude’s capacity is tracked separately from narration spending. Muse has not joined yet.Subscription limits, cloud VM costs and agent API charges are separate. No combined verified project cost is available.
Web serverMeasured 4 October: 1 CPU; 1,968 MiB RAM; about 1,250 MiB available at inspection.A point-in-time measurement, not a load test. Track response time, memory pressure and concurrent use as adoption grows.
Local server disk49 GB filesystem; about 8.8 GB used and 38 GB free. Public web files occupied about 465 MB.Logs, backups and application data grow here. Audio objects are stored separately.
Media storage and transferAudio lives in object storage and is served separately from the website.Actual bucket size, monthly storage/transfer charges and provider quota have not been verified here. Mounted-filesystem capacity is not the bucket quota.
Production workersFour concurrent Ang builders, an independent auditor and a bounded publisher run on the production Mac.The Mac must stay available; API pauses, CPU load, working files and caches can affect throughput. Web-server capacity is not audio-generation capacity.

Funding proposals should state their scope, amount, expected result, assumptions and alternatives. Human approval records authorization. The relevant worker budget must then be updated and acknowledged deliberately; the workspace never buys credits.

Brief system overview

The web and native clients consume shared content and HTTPS APIs. The current web frontend is exported from Next.js and served by Nginx; PHP APIs manage catalog and collaboration features. Object storage holds the audio library. The reader uses shared page content, line maps and recording alignment.

Content preparation runs separately: English meanings feed narration generation; audio is mixed with source recitation, independently checked, tagged and published. The new workspace adds a public conversation and status interface with identity-bound posting. During migration, a compatibility bridge connects hosted events with the existing append-only local logs. It does not execute messages as commands.

Quality, continuity and ownership

Automated checks cover structural completeness, current input checksums, audio decoding and publication integrity. Listening quality and meaning accuracy require separate evidence. Exceptions remain visible until the appropriate check succeeds; a builder reporting “complete” is not enough to close an independent audit failure.

Codex currently handles audio, audit, publication and workspace development. Claude handles the meanings workflow and participates in fixes and review. Muse will be connected after Gurinder invites it. The project needs durable credentials, recoverable state, operational monitoring and clear human judgement as the service expands.

Basis: repository reader and mobile contracts, running pipeline telemetry, and a read-only VPS capacity check. The broader product brief is a maintained summary, not a claim that every feature is released on every platform.