HodeTech/ForgeLM

View on GitHub

Config-driven LLM fine-tuning with safety evaluation, EU AI Act compliance, 6 alignment methods, and one-command bundled quickstart templates.

Is HodeTech/ForgeLM beginner-friendly?

We have not seen enough recent pull requests from outside contributors to HodeTech/ForgeLM to say how often they are merged. 243 beginner-friendly issues are open now.

Stars: 9
Forks: 1
Open beginner issues: 243
Indexed issues: 858
Avg merge: 8h 10m
Merged PRs (30d): 5

Dominant language: Python
License: Apache-2.0
Last GitHub push: Oct 9, 2026
Latest indexed: Oct 10, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: good first issue help wanted

How to contribute to HodeTech/ForgeLM

Read the contributing guide first: it says how the maintainers want changes proposed, tested and reviewed.
It ships a Dockerfile or Docker Compose file, so you can run it without installing its whole toolchain.
Read its code of conduct: it covers issues and pull requests as well as chat.
Pick one of the 243 open beginner-friendly issues below and comment that you want to work on it before you start.

Beginner friendly Everything

Open All

Issues somebody may already be working on are listed last. List everything by date

[Epic] Deferred work · conditions and budgets recorded in risks-and-decisions.md
Open
- Is something wrong?
epic source: roadmap

Difficulty 5/5 Over a week Newbie friendliness 5/100

HodeTech/ForgeLM#929 · Opened Oct 9, 2026
Type the webhook payload as a `WebhookPayload` TypedDict so unknown or mistyped keys are caught statically
Open
- Is something wrong?
area: integrations severity: low source: roadmap wave: 4

Difficulty 3/5 1-3 hours Newbie friendliness 42/100

HodeTech/ForgeLM#928 · Opened Oct 9, 2026
`sonar-project.properties` names a SonarCloud project that does not exist (`HodeTech_ForgeLM`), so its sources and exclusions are probably not applied
Open
- Is something wrong?
area: dev-tooling bug severity: low source: roadmap wave: 4

Difficulty 2/5 1-3 hours Newbie friendliness 70/100

HodeTech/ForgeLM#927 · Opened Oct 9, 2026
Retire two PR #29 deferral rows whose work is done or moot (F-PR29-A8-07, F-PR29-A8-02 / C-2)
Open
- Is something wrong?
documentation severity: low source: roadmap wave: 4

Difficulty 2/5 Under an hour Newbie friendliness 50/100

HodeTech/ForgeLM#926 · Opened Oct 9, 2026
Embedding-based `semantic` chunking (the strategy behind ingestion's `NotImplementedError`) — deferred until a deterministic-snapshot mode is designed
Open
- Is something wrong?
area: ingestion deferred severity: low source: roadmap wave: 4

Difficulty 5/5 Over a week Newbie friendliness 8/100

HodeTech/ForgeLM#925 · Opened Oct 9, 2026
Implement `output.cost_tracking` (per-GPU rates, alert / halt thresholds, audit and webhook events) — or retire the promise
Open
- Is something wrong?
area: config severity: medium source: roadmap wave: 3

Difficulty 4/5 3-5 days Newbie friendliness 18/100

HodeTech/ForgeLM#924 · Opened Oct 9, 2026
Reconcile `code-review.md`'s finding-ID convention with the ID schemes in use (CR-/DOC-/TECH-, F-P4-OPUS, F-P8-C)
Open
- Is something wrong?
documentation severity: low source: roadmap wave: 4

Difficulty 3/5 1-2 days Newbie friendliness 25/100

HodeTech/ForgeLM#923 · Opened Oct 9, 2026
Pin batch-size invariance of safety and judge generation in fp32 (`batch_size` 1 / 2 / 4 / 8)
Open
- Is something wrong?
area: eval-gates help wanted severity: low source: roadmap wave: 4

Difficulty 3/5 Half a day Newbie friendliness 62/100

HodeTech/ForgeLM#922 · 1 comment · Opened Oct 9, 2026
Pilot ruff's pydocstyle (`D`, Google convention) and pyupgrade (`UP`) rules on `forgelm/`
Open
- Is something wrong?
area: dev-tooling severity: low source: roadmap wave: 4

Difficulty 3/5 1-2 days Newbie friendliness 42/100

HodeTech/ForgeLM#921 · Opened Oct 9, 2026
Replace the ~31-command self-review chain triplicated in CLAUDE.md, AGENTS.md and CONTRIBUTING.md with `tools/gauntlet.sh` — deferred until a decision row approves it
Open
- Is something wrong?
area: dev-tooling deferred severity: low source: roadmap wave: 4

Difficulty 3/5 Half a day Newbie friendliness 20/100

HodeTech/ForgeLM#920 · Opened Oct 9, 2026
Single-source the public-surface mypy gate in `[tool.mypy]` instead of four hand-copied flag strings
Open
- Is something wrong?
area: dev-tooling help wanted severity: low source: roadmap wave: 4

Difficulty 3/5 Half a day Newbie friendliness 62/100

HodeTech/ForgeLM#919 · 1 comment · Opened Oct 9, 2026
Add `WebhookNotifier.SUPPORTED_EVENTS` and a `--strict` guard holding `webhook_schema.md`'s event table to the emission sites
Open
- Is something wrong?
area: integrations severity: low source: roadmap wave: 4

Difficulty 3/5 1-2 days Newbie friendliness 55/100

HodeTech/ForgeLM#918 · Opened Oct 9, 2026
Internal mypy debt has grown past its recorded budget: 108 errors in 36 files against 106 in 35
Open
- Is something wrong?
area: dev-tooling severity: low source: roadmap wave: 4

Difficulty 4/5 3-5 days Newbie friendliness 25/100

HodeTech/ForgeLM#917 · Opened Oct 9, 2026
Publish an official ForgeLM container image — deferred until a weight-redistribution position and the Docker standard exist
Open
- Is something wrong?
area: packaging-ci deferred severity: medium source: roadmap wave: 3

Difficulty 5/5 Over a week Newbie friendliness 8/100

HodeTech/ForgeLM#916 · Opened Oct 9, 2026
verify-gguf: fail closed by default when no strong layer ran (magic-only verdict) — deferred until the next MAJOR release
Open
- Is something wrong?
area: verify deferred severity: medium source: roadmap wave: 3

Difficulty 2/5 1-3 hours Newbie friendliness 15/100

HodeTech/ForgeLM#915 · Opened Oct 9, 2026
Benchmark gate: optional valid-task fraction floor, so one flaky lm-eval task does not fail a multi-task run — deferred until a real run reports a flaky-task false failure
Open
- Is something wrong?
area: eval-gates deferred severity: low source: roadmap wave: 4

Difficulty 3/5 1-2 days Newbie friendliness 25/100

HodeTech/ForgeLM#914 · Opened Oct 9, 2026
Make the anonymous-operator audit gate config-driven: add `compliance.allow_anonymous_operator` beside `FORGELM_ALLOW_ANONYMOUS_OPERATOR`
Open
- Is something wrong?
area: config severity: low source: roadmap wave: 4

Difficulty 3/5 Half a day Newbie friendliness 25/100

HodeTech/ForgeLM#913 · Opened Oct 9, 2026
Decide what `tests/runtime_smoke.py` is: pytest never collects it, it writes `tmp_smoke_test/` into the cwd, and `testing.md` misdescribes it
Open
- Is something wrong?
area: dev-tooling severity: low source: roadmap wave: 4

Difficulty 3/5 Half a day Newbie friendliness 30/100

HodeTech/ForgeLM#912 · Opened Oct 9, 2026
Rename the ten phase/faz-named test modules to feature names and add a guard against `test_(phase|faz)N` file names
Open
- Is something wrong?
area: dev-tooling severity: low source: roadmap wave: 4

Difficulty 3/5 1-2 days Newbie friendliness 55/100

HodeTech/ForgeLM#911 · Opened Oct 9, 2026
Adopt the `minimal_config` test factory across the suite and add a CI guard on its adoption rate
Open
- Is something wrong?
area: dev-tooling severity: low source: roadmap wave: 4

Difficulty 4/5 3-5 days Newbie friendliness 45/100

HodeTech/ForgeLM#910 · Opened Oct 9, 2026
Split `forgelm/cli/_pipeline.py` into a sub-package (`_state`, `_events`, `_verify`)
Open
- Is something wrong?
area: pipeline severity: low source: roadmap wave: 4

Difficulty 4/5 1-2 days Newbie friendliness 35/100

HodeTech/ForgeLM#909 · Opened Oct 9, 2026
Split `forgelm/cli/subcommands/_purge.py` into a sub-package (`_row_id`, `_run_id`, `_check_policy`, `_shared`) — deferred until Phase 16 S9 has landed
Open
- Is something wrong?
area: gdpr-approval deferred severity: low source: roadmap wave: 4

Difficulty 4/5 3-5 days Newbie friendliness 15/100

HodeTech/ForgeLM#908 · Opened Oct 9, 2026
Split `forgelm/cli/_parser.py` into a sub-package (`_train`, `_inspect`, `_data`, `_run`) — deferred until Phase 16 S5, S7 and S11 have landed
Open
- Is something wrong?
area: cli deferred severity: low source: roadmap wave: 4

Difficulty 4/5 3-5 days Newbie friendliness 18/100

HodeTech/ForgeLM#907 · Opened Oct 9, 2026
Split `forgelm/compliance.py` into a sub-package (`_audit_log`, `_annex_iv`, `_provenance`, `_gdpr`) — deferred until Phase 16 S9 has landed
Open
- Is something wrong?
area: compliance deferred severity: low source: roadmap wave: 4

Difficulty 4/5 1-2 days Newbie friendliness 18/100

HodeTech/ForgeLM#906 · Opened Oct 9, 2026
Split `forgelm/ingestion.py` into a sub-package (`_readers`, `_chunkers`, `_pipeline`) — deferred until the next change that adds a reader or a chunker
Open
- Is something wrong?
area: ingestion deferred severity: low source: roadmap wave: 4

Difficulty 4/5 3-5 days Newbie friendliness 25/100

HodeTech/ForgeLM#905 · Opened Oct 9, 2026
Split `forgelm/trainer.py` into a sub-package (`_kwargs`, `_runtime`, `_finalize`, `_artifacts`) — deferred until Phase 16 S4 and S8 have landed
Open
- Is something wrong?
area: trainer deferred severity: low source: roadmap wave: 4

Difficulty 4/5 3-5 days Newbie friendliness 18/100

HodeTech/ForgeLM#904 · Opened Oct 9, 2026
[Epic] Phase 16 · Trust surface hardening: remaining steps S4–S16
Open
- Is something wrong?
epic phase: 16 source: roadmap

Difficulty 5/5 Over a week Newbie friendliness 8/100

HodeTech/ForgeLM#903 · Opened Oct 9, 2026
[Phase 16] S16 — Documentation source-of-truth and localization governance
Open
- Is something wrong?
phase: 16 source: roadmap

Difficulty 5/5 Over a week Newbie friendliness 15/100

HodeTech/ForgeLM#902 · Opened Oct 9, 2026
[Phase 16] S15 — Documentation: claims bound to code
Open
- Is something wrong?
phase: 16 source: roadmap

Difficulty 4/5 3-5 days Newbie friendliness 45/100

HodeTech/ForgeLM#901 · Opened Oct 9, 2026
[Phase 16] S14 — Test-quality ratchet
Open
- Is something wrong?
phase: 16 source: roadmap

Difficulty 5/5 Over a week Newbie friendliness 12/100

HodeTech/ForgeLM#900 · Opened Oct 9, 2026
[Phase 16] S13 — Packaging metadata, dependency single-source, container distribution
Open
- Is something wrong?
phase: 16 source: roadmap

Difficulty 5/5 Over a week Newbie friendliness 12/100

HodeTech/ForgeLM#899 · Opened Oct 9, 2026
[Phase 16] S12 — Release DAG and release-time evidence
Open
- Is something wrong?
phase: 16 source: roadmap

Difficulty 5/5 Over a week Newbie friendliness 8/100

HodeTech/ForgeLM#898 · Opened Oct 9, 2026
[Phase 16] S11 — Deploy/serving generator contract
Open
- Is something wrong?
phase: 16 source: roadmap

Difficulty 4/5 3-5 days Newbie friendliness 30/100

HodeTech/ForgeLM#897 · Opened Oct 9, 2026
[Phase 16] S10 — Data-layer fidelity, scale and privacy
Open
- Is something wrong?
phase: 16 source: roadmap

Difficulty 5/5 Over a week Newbie friendliness 10/100

HodeTech/ForgeLM#896 · Opened Oct 9, 2026
[Phase 16] S9 — Compliance evidence integrity and GDPR erasure completeness
Open
- Is something wrong?
phase: 16 source: roadmap

Difficulty 4/5 Over a week Newbie friendliness 22/100

HodeTech/ForgeLM#895 · Opened Oct 9, 2026
[Phase 16] S8 — Run-scoped effective state and provenance
Open
- Is something wrong?
phase: 16 source: roadmap

Difficulty 5/5 Over a week Newbie friendliness 12/100

HodeTech/ForgeLM#894 · Opened Oct 9, 2026
[Phase 16] S7 — CLI and wizard boundary: policy declared must be policy enforced
Open
- Is something wrong?
phase: 16 source: roadmap

Difficulty 5/5 Over a week Newbie friendliness 12/100

HodeTech/ForgeLM#893 · Opened Oct 9, 2026
[Phase 16] S6 — Invocation-owned resources: temp state, atomic writes, worker lifetime
Open
- Is something wrong?
phase: 16 source: roadmap

Difficulty 4/5 3-5 days Newbie friendliness 24/100

HodeTech/ForgeLM#892 · Opened Oct 9, 2026
[Phase 16] S5 — Verification truth: three states, not a success bit
Open
- Is something wrong?
phase: 16 source: roadmap

Difficulty 5/5 Over a week Newbie friendliness 12/100

HodeTech/ForgeLM#891 · Opened Oct 9, 2026
[Phase 16] S4 — Dependency-range truth for the six advertised trainers
Open
- Is something wrong?
phase: 16 source: roadmap

Difficulty 4/5 3-5 days Newbie friendliness 20/100

HodeTech/ForgeLM#890 · Opened Oct 9, 2026
[Phase 16] Write the SBOM / supply-chain standard (prerequisite of S12)
Open
- Is something wrong?
documentation phase: 16 source: roadmap

Difficulty 5/5 3-5 days Newbie friendliness 18/100

HodeTech/ForgeLM#889 · Opened Oct 9, 2026
[Phase 16] Write the Docker standard (prerequisite of S13)
Open
- Is something wrong?
documentation phase: 16 source: roadmap

Difficulty 3/5 Half a day Newbie friendliness 42/100

HodeTech/ForgeLM#888 · Opened Oct 9, 2026
Site: the theme-locked --code-comment grey (#6a6f80) on the dark code surface is 3.8:1, below WCAG AA, in both themes (F-W1-SITE-06)
Open
- Is something wrong?
area: site bug good first issue severity: low source: review-2026-09 wave: 4

Difficulty 2/5 1-3 hours Newbie friendliness 66/100

HodeTech/ForgeLM#887 · Opened Oct 9, 2026
GDPR erasure design names Article 5(1)(b) as the lawful basis for logging operator identity; the lawful bases are in Article 6 (F-W1-PROCESS-04)
Open
- Is something wrong?
documentation severity: medium source: review-2026-09 wave: 3

Difficulty 3/5 Half a day Newbie friendliness 42/100

HodeTech/ForgeLM#886 · Opened Oct 9, 2026
Choosing-a-trainer table documents KTO rows as {prompt, response, label}, but the KTO loader requires a completion column (F-W1-DOCS-TRAIN-02)
Open
- Is something wrong?
documentation good first issue severity: medium source: review-2026-09 wave: 3

Difficulty 2/5 1-3 hours Newbie friendliness 75/100

HodeTech/ForgeLM#885 · Opened Oct 9, 2026
Trend-tracking jq recipe prints evaluation_completed=false as 'n/a', because jq's // operator treats false like null (F-W1-DOCS-TRAIN-16)
Open
- Is something wrong?
documentation good first issue severity: low source: review-2026-09 wave: 4

Difficulty 1/5 1-3 hours Newbie friendliness 80/100

HodeTech/ForgeLM#884 · Opened Oct 9, 2026
Ingestion guide's AWS Textract recipe reads only the first GetDocumentTextDetection page and never checks JobStatus, silently truncating multi-page OCR text (F-W1-DOCS-TRAIN-13)
Open
- Is something wrong?
documentation severity: medium source: review-2026-09 wave: 3

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

HodeTech/ForgeLM#883 · Opened Oct 9, 2026
Encryption-at-rest guide says rotating the SSE-KMS key re-encrypts existing model files; KMS key rotation does not re-encrypt stored objects (F-W1-DOCS-TRUST-19)
Open
- Is something wrong?
documentation security severity: medium source: review-2026-09 wave: 3

Difficulty 2/5 1-3 hours Newbie friendliness 55/100

HodeTech/ForgeLM#882 · Opened Oct 9, 2026
Incident-response SOP's 'Isolate' step (chmod 0500 on <output_dir>) does not stop writes to existing evidence files, subdirectories or open handles (F-W1-DOCS-TRUST-18)
Open
- Is something wrong?
documentation security severity: medium source: review-2026-09 wave: 3

Difficulty 3/5 Half a day Newbie friendliness 45/100

HodeTech/ForgeLM#881 · Opened Oct 9, 2026
DPO manual and CLI wizard reverse dpo_beta: they say a lower beta keeps the model closer to the reference model, but in TRL a higher beta does (F-W1-DOCS-TRAIN-07)
Open
- Is something wrong?
documentation good first issue severity: medium source: review-2026-09 wave: 3

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

HodeTech/ForgeLM#880 · Opened Oct 9, 2026

Showing the newest 100

This page lists what was indexed most recently. Advanced filter has the whole inventory, narrowed by language, difficulty and how long a task takes.

Open advanced filter

HodeTech/ForgeLM

Is HodeTech/ForgeLM beginner-friendly?

How to contribute to HodeTech/ForgeLM

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Is something wrong?

Showing the newest 100

Get new issues in your inbox