A free, open-source learning platform that teaches industrial professions the way real craftsmen actually learn: by reading official standards (ГОСТ, ASME, НАКС) and doing verifiable, real-world practice.
A lesson: why it matters → the official standards to read → a verifiable task → one binary done.
⭐ Like the idea of a free, open encyclopedia of the trades? Star the repo — it's the cheapest way to help it find the experts who'll grow it. · Support development →
Wikipedia made the world's knowledge free and open — but the deep, practical know-how of the trades never really made it in. How you actually wire a panel, weld a seam or commission a sensor still lives locked away: in scattered standards, paywalled video courses, and the heads of a retiring generation.
IndustrialProfi is building the open commons for that knowledge — think a Wikipedia for the trades, with two differences that matter: a guided path (profession → course → lesson, so you always know what to learn next), and a friendly builder instead of a wall of wiki-markup — so a working electrician can improve a lesson without first becoming a wiki editor.
The raw material already exists — it lives in ГОСТ, ПУЭ, НАКС and ASME standards — but it's scattered, intimidating, and unmapped. Welders, electricians and instrumentation techs across the CIS have no structured, free, standards-based path to grow. So we curate one into clear career roadmaps:
Profession → Course → Lesson
(Электрик) (Охрана труда) (ПУЭ: Правила устройства электроустановок)
The library: every official standard, book and tool — curated per profession, ranked, and linked from the lessons that use it. An open encyclopedia of the trades, in the making.
Every lesson follows the same honest, no-fluff structure — read the real source, then prove you can use it:
- WHY — one or two sentences on why this matters on the job site.
- OFFICIAL DOCUMENTS — curated links to the real standards, grouped into required and recommended, each with a one-line note on what exactly to read in a 400-page document. No paraphrasing — you read the source.
- PRACTICAL TASK — a concrete, verifiable assignment where the skill warrants one; thoughtful self-check questions against the standard otherwise.
- ✓ Mark as done — binary progress. Done or not done, nothing in between.
Course progress is simply completed / total. No "in progress", no fake
gamification — just a clear map of what you know and what's next.
Theory is half of it. Every profession also has real, verifiable practice — paper-and-bench drills for beginners up to capstone builds — the part that actually makes a craftsman.
There's no shortage of ways to learn a trade online. Almost all of them are either free-but-scattered or structured-but-paid, and almost none are built on the official standards or open for the community to improve. The combination is the point:
| IndustrialProfi | Paid video courses | Scattered standards / PDFs | YouTube tutorials | |
|---|---|---|---|---|
| Free — forever, not a trial | ✅ | ❌ | ✅ | ✅ |
| Built on official standards (ГОСТ/ПУЭ/НАКС) | ✅ | ✅ (raw, unsorted) | ❌ | |
| Structured path: profession → course → lesson | ✅ | ✅ | ❌ | ❌ |
| Hands-on, verifiable practice | ✅ | ❌ | ||
| Open content, community-editable (CC BY-SA) | ✅ | ❌ | ❌ | ❌ |
| No ads, no upsell, no account wall to read | ✅ | ❌ | ✅ | ❌ |
We're early and don't pretend otherwise — a paid course will have more polish today. What no one else has is all six columns at once: the structured depth of a course, the authority of the source standards, and the openness of a wiki — free for good.
A platform this broad can't be written by one person — and it isn't meant to be. So the editor's side of the screen got the same care as the reader's. We're unashamed magpies: we took mechanics proven by apps we admire and adapted them for the trades — the calm editor and UX of Basecamp's open-source Rails apps, the structured roadmaps and resource taxonomy of roadmap.sh, and Wikipedia's immutable revision history and review pipeline. The result is a workshop that's comfortable on both sides: the learner reading it, and the expert improving it.
The lesson editor: rich text + the official documents, each typed, ranked and drag-sorted. A friendly builder — not a wall of wiki-markup.
Curriculum builder — drag whole courses, sections and lessons into order. The whole profession, on one screen. |
Suggestion review — any reader can propose an edit; an expert weighs it side-by-side; the applied change becomes an immutable revision. |
This is a deliberately boring, build-step-free Rails app — and that's the point. It's a reference for how much you can ship with vanilla Rails 8 and Hotwire, no Node.js anywhere in sight.
- Ruby 4.0 / Rails 8.1
- SQLite3 + Solid Queue, Solid Cache, Solid Cable
- Hotwire (Turbo + Stimulus) — server-rendered HTML, no SPA
- Pure CSS — no Tailwind, no PostCSS, no Node;
dartsass-railsonly concatenates and minifies the plain files. The cascade is filenames in alphabetical order. - Importmap — no Node, no Webpack, no Vite
- Auth via
has_secure_password(bcrypt) — no Devise - Kamal 2 + Docker + Thruster for deploys
- Minitest + fixtures + Capybara
- Self-hosted Inter / Inter Tight via
@font-face, OKLCH color tokens, a single black-first dark theme — UI patterns mirror Basecamp's open-source apps (Writebook, Fizzy).
You need the Ruby version in .ruby-version and Git. No Node, no Yarn, no asset pipeline to configure.
git clone https://github.com/andreiyurik/industrialprofi.git
cd industrialprofi
bin/setup # installs gems, prepares the database, seeds sample data
bin/dev # starts the server at http://localhost:3000Common tasks:
bin/rails test # run the test suite
bin/rails test:system # system tests (Capybara)
bin/rails db:migrate # run migrations
bin/rubocop # lintapp/models/ # domain models (Path, Course, Lesson, ...)
app/controllers/ # RESTful controllers, render ERB
app/views/ # ERB templates + Turbo Frame/Stream partials
app/javascript/controllers/ # Stimulus controllers
app/assets/stylesheets/ # all CSS — one self-contained file per component
db/migrate/ # migrations = source of truth for schema
docs/ # project wiki — start at docs/README.md (English)
tools/ # content-authoring canon and prompts (Russian)
AGENTS.md # instructions for AI coding agents
CLAUDE.md # imports AGENTS.md + Claude Code specifics; config in .claude/
Content hierarchy:
Path (profession) → Course → Lesson → Resource (links to standards)
User → LessonCompletion (binary: the row exists = the lesson is done)
IndustrialProfi ships in phases — the forward roadmap lives in docs/VISION.md → Roadmap & scope:
- v0.1 — shipped: static catalog (professions → courses → lessons, public, SEO-first)
- v0.2 — shipped: accounts, binary progress, dashboard, practice journal, activity heatmap, reader suggestions + revision history, admin panel with roles, full-text search (SQLite FTS5) + command palette, practice projects, calculators, content export
- v0.3 — next: community-authored roadmaps (draft → review → published), public profiles, moderated portfolio
The user-facing roadmap lives at /roadmap on the site itself; the full product
thinking lives in docs/VISION.md.
Contributions are welcome — whether you write code or curate the content that actually teaches people. Start with CONTRIBUTING.md.
A quick heads-up on the model: the platform is and stays open source under
AGPL-3.0, and the learning content stays free. The project sustains itself with
services around the code — on-prem deployments and support for enterprises
and training centers — never by closing features or selling the content.
Contributors sign a lightweight CLA so the project keeps the freedom to sustain
itself; details in CONTRIBUTING.md.
IndustrialProfi is dual-licensed:
- Code — GNU Affero General Public License v3.0 (AGPL-3.0).
- Content — the curriculum and lessons are licensed under Creative Commons Attribution-ShareAlike 4.0 (CC BY-SA 4.0).
In plain terms: you're free to use, study, share and modify the code — and if you run a modified version as a network service, you must make your source available too. The learning content you're free to share and adapt (even commercially), as long as you credit IndustrialProfi and keep it under the same license. Third-party standards (ГОСТ, ASME, НАКС…) are only linked or cited and remain their publishers' property.
Standing on the shoulders of projects that showed the way:
- The Odin Project — the open-curriculum model and the read-the-docs-then-build philosophy.
- roadmap.sh — structured, visual career roadmaps.
- Basecamp — the open-source Rails apps (Writebook, Fizzy, Once-Campfire) whose design and code conventions this project follows.
If you believe the trades deserve an open, standards-based commons: star the repo, support development, or help build it — code or content, both move it forward.
Built for the people who keep the lights on, the pipes welded, and the machines running.