PyPI - crewforge - Versions diffs - 0.2.1__tar.gz → 0.2.2__tar.gz - Mend

crewforge 0.2.1tar.gz → 0.2.2tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (79) hide show

{crewforge-0.2.1/src/crewforge.egg-info → crewforge-0.2.2}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crewforge
-Version: 0.2.1
+Version: 0.2.2
 Summary: One crew of LLM agents, five recipes: code review, document Q&A, API scaffolding, content and honest academic-writing help — on any OpenAI-compatible provider.
 Author: Muhammad Aiman
 License-Expression: MIT
@@ -56,15 +56,21 @@ Requires-Dist: fastapi>=0.110; extra == "dev"
 Requires-Dist: httpx>=0.27; extra == "dev"
 Dynamic: license-file
-# crewforge
+<p align="center"><img src="https://raw.githubusercontent.com/aimanmalib/crewforge/main/brand/logo-512.png" width="112" height="112" alt="crewforge"></p>
-**One crew of LLM agents, five recipes — code review, document Q&A, API scaffolding, content and honest academic-writing help — on any OpenAI-compatible provider, and it fails loudly instead of pretending.**
+<h1 align="center">crewforge</h1>
-[![CI](https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml/badge.svg)](https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml)
-[![PyPI](https://img.shields.io/pypi/v/crewforge)](https://pypi.org/project/crewforge/)
-[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/aimanmalib/crewforge/badge)](https://scorecard.dev/viewer/?uri=github.com/aimanmalib/crewforge)
-![Python 3.10–3.14](https://img.shields.io/badge/python-3.10%E2%80%933.14-blue)
-![License: MIT](https://img.shields.io/badge/license-MIT-green)
+<p align="center"><a href="https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml"><img src="https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://pypi.org/project/crewforge/"><img src="https://img.shields.io/pypi/v/crewforge" alt="PyPI"></a> <a href="https://scorecard.dev/viewer/?uri=github.com/aimanmalib/crewforge"><img src="https://api.scorecard.dev/projects/github.com/aimanmalib/crewforge/badge" alt="OpenSSF Scorecard"></a> <img src="https://img.shields.io/badge/python-3.10%E2%80%933.14-blue" alt="Python 3.10–3.14"> <a href="https://github.com/aimanmalib/crewforge/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"></a></p>
+<p align="center"><b>One crew of LLM agents, five recipes, any OpenAI-compatible provider.</b> · <i>Satu kru ejen LLM, lima resipi, mana-mana penyedia serasi OpenAI.</i><br>
+<a href="https://pypi.org/project/crewforge/">PyPI</a> · <a href="https://github.com/aimanmalib/crewforge/blob/main/CHANGELOG.md">changelog</a> · <a href="https://github.com/aimanmalib/crewforge/blob/main/docs/porting.md">porting notes</a> · Built in Malaysia by <a href="https://aimanmalib.com">Aiman Malib</a></p>
+crewforge is a command-line tool and Python library that runs a crew of LLM agents through five recipes: code
+review, document Q&A, API scaffolding, content writing and honest academic-writing help. It works with any
+OpenAI-compatible provider, reads API keys only from the environment, and fails loudly instead of pretending: a run
+in which an agent produced nothing exits with code 1 and names that agent.
+[Bahasa Melayu ↓](#bahasa-melayu)
 ```bash
 crewforge review src/                                  # six reviewers + a summary
@@ -81,7 +87,7 @@ crewforge academic feedback draft.md --brief brief.md --language ms
 ## Why one crew, many recipes
-crewforge started as four separate command-line tools —
+crewforge started as four separate command-line tools:
 [codeguard](https://github.com/aimanmalib/codeguard),
 [documind](https://github.com/aimanmalib/documind),
 [apiforge](https://github.com/aimanmalib/apiforge) and
@@ -95,7 +101,7 @@ showed the copies had drifted and that each hid its failures differently:
 - apiforge scored a spec with **no endpoints** 100/100;
 - contentforge wrote the real API key into its YAML file, and sent `${OPENAI_API_KEY}` literally as the key.
-crewforge keeps one core — so a fix lands once — and turns each tool into a
+crewforge keeps one core, so a fix lands once, and turns each tool into a
 *recipe*: a set of agents plus the steps that connect them. The same core rules
 apply to every recipe: non-streaming requests, bounded retries, usage numbers
 taken only from the provider, keys only from the environment, and no run that
@@ -290,13 +296,13 @@ Saya menggunakan crewforge academic (versi 0.1.0), sebuah alat berbantukan AI, d
 - 22 Oktober 2026: Perancangan: alat ini menukar taklimat tugasan (brief-ms.md) kepada 3 soalan kajian, rangka 5 bahagian dan peruntukan perkataan. ...
 ```
-How sources are labelled — there is no "verified" status, because the tool
+How sources are labelled: there is no "verified" status, because the tool
 cannot check that a source exists:
 | Source | Label |
 |---|---|
 | You supplied it | *supplied by you (not checked online)* |
-| The model proposed it, with a DOI, URL or valid ISBN | **UNVERIFIED** — check it |
+| The model proposed it, with a DOI, URL or valid ISBN | **UNVERIFIED**: check it |
 | The model proposed it with none of those | **LIKELY FABRICATED** |
 | The model added a DOI/URL/ISBN to a reference you supplied | **UNVERIFIED**, naming the added identifier |
@@ -335,16 +341,16 @@ An unknown provider name is a configuration error, not a silent fallback.
 <sub>Source: [docs/architecture.mmd](https://github.com/aimanmalib/crewforge/blob/main/docs/architecture.mmd) (re-render with `scripts/render_architecture.py`).</sub>
-- **`core/client.py`** — one async client. It always sends `"stream": false`,
+- **`core/client.py`**: one async client. It always sends `"stream": false`,
   retries only HTTP 429, 5xx and network/timeout errors (with capped exponential
   backoff that honours `Retry-After`), and fails on the first 401/403/4xx with a
   message naming the variable to fix. The key is only ever a request header.
-- **`core/agent.py`** — an agent is a role, a system prompt and per-agent
+- **`core/agent.py`**: an agent is a role, a system prompt and per-agent
   sampling defaults. `ask()` records usage and raises if the reply is blank;
   `ask_json()` additionally requires parseable JSON (optionally a pydantic schema).
-- **`core/crew.py`** — runs agents as sequential steps or parallel stages and
+- **`core/crew.py`**: runs agents as sequential steps or parallel stages and
   turns any failure into a `CrewFailedError` that lists every failed agent.
-- **`core/usage.py`** — per-agent calls, tokens, retries and latency, taken from
+- **`core/usage.py`**: per-agent calls, tokens, retries and latency, taken from
   the provider's `usage` object. Calls without usage are counted as "not reported",
   never estimated.
@@ -409,10 +415,10 @@ watching them fail; see [docs/porting.md](https://github.com/aimanmalib/crewforg
 crewforge was built with AI coding assistance (Claude Code) under the
 direction of its author, Muhammad Aiman. It consolidates four earlier tools by
-the same author — [codeguard](https://github.com/aimanmalib/codeguard),
+the same author ([codeguard](https://github.com/aimanmalib/codeguard),
 [documind](https://github.com/aimanmalib/documind),
 [apiforge](https://github.com/aimanmalib/apiforge) and
-[contentforge](https://github.com/aimanmalib/contentforge) — whose test suites
+[contentforge](https://github.com/aimanmalib/contentforge)), whose test suites
 were carried over into this repository (see [docs/porting.md](https://github.com/aimanmalib/crewforge/blob/main/docs/porting.md)
 for what was ported, re-targeted at the shared core, or dropped and why).
@@ -435,10 +441,52 @@ Please report vulnerabilities privately through
 See [SECURITY.md](https://github.com/aimanmalib/crewforge/blob/main/SECURITY.md) for scope notes (what is sent to your provider,
 and what `validate` executes).
-## License
+## Bahasa Melayu
+crewforge ialah alat baris arahan dan pustaka Python yang menjalankan satu kru ejen LLM melalui lima resipi:
+semakan kod (`review`), soal jawab dokumen (`ask`, `summarize`), penjanaan projek API FastAPI (`scaffold`,
+`validate`), penulisan kandungan (`write`) dan bantuan penulisan akademik yang jujur (`academic`). Ia berfungsi
+dengan mana-mana penyedia serasi OpenAI, termasuk model tempatan melalui Ollama atau llama.cpp. Kunci API hanya
+dibaca dari pemboleh ubah persekitaran, tidak pernah ditulis ke fail.
+**Mengapa satu kru.** crewforge menggabungkan empat alat lama (codeguard, documind, apiforge, contentforge) yang
+masing-masing menyimpan salinan sendiri bagi rangka yang sama. Salinan itu sudah berbeza dan setiap satu
+menyembunyikan kegagalan dengan cara sendiri. Kini teras dikongsi: pembaikan dibuat sekali, dan setiap alat menjadi
+resipi di atas teras itu.
+**Gagal dengan jelas.** Larian yang ejennya memulangkan jawapan kosong atau tidak boleh dihurai, atau pengesah
+yang tidak menyemak apa-apa, keluar dengan kod 1 dan menamakan ejen itu. Kod keluar: `0` berjaya, `1` larian
+gagal, `2` ralat penggunaan atau konfigurasi. Bilangan token diambil daripada laporan penyedia sahaja, tidak
+dianggar.
+**Resipi `academic`.** Membantu pelajar dan penyelidik dengan kerja mereka **sendiri**: merancang dari taklimat
+tugasan, memberi ulasan atas draf tanpa menulis semula, memformat rujukan yang diberi pengguna (APA 7, IEEE,
+Harvard) tanpa menambah rujukan baharu, dan menulis pernyataan penggunaan AI daripada rekod langkah yang
+dijalankan. Output dalam bahasa Inggeris atau Bahasa Melayu (`--language ms`); output BM disemak untuk bentuk
+Indonesia seperti *karena* atau *kualitas*. Sumber yang dicadangkan model dilabel UNVERIFIED, atau LIKELY
+FABRICATED jika tiada DOI, URL atau ISBN. Tiada ciri "humanise" atau mengelak pengesan AI.
+**Pasang dan guna.**
+```bash
+pip install crewforge                 # Python 3.10 hingga 3.14
+pip install "crewforge[docs,api]"     # pilihan: PDF/DOCX dan semakan aplikasi FastAPI
+export OPENAI_API_KEY=sk-...          # atau penyedia lain, lihat `crewforge providers`
+crewforge review src/
+crewforge academic feedback draf.md --brief taklimat.md --language ms
+```
+Senarai penyedia, contoh setiap resipi dan seni bina ada dalam bahagian bahasa Inggeris di atas
+([Providers](https://github.com/aimanmalib/crewforge#providers), [Recipes](https://github.com/aimanmalib/crewforge#recipes)).
+## Licence
+[MIT](https://github.com/aimanmalib/crewforge/blob/main/LICENSE) © Muhammad Aiman. Made by [Aiman Malib](https://aimanmalib.com), Malaysia.
+## Work with Sasa Teguh
-[MIT](https://github.com/aimanmalib/crewforge/blob/main/LICENSE) © Muhammad Aiman
+[![Work with Sasa Teguh: book a call](https://raw.githubusercontent.com/sasateguh/.github/main/assets/work-with-sasa-teguh.png)](https://sasateguh.com/book)
----
+I built this project. I run [Sasa Teguh](https://sasateguh.com), a studio in Malaysia that builds websites found on Google and in AI answers, and sets up systems like this one for businesses.
-Built by [Sasa Teguh](https://sasateguh.com) · Malaysia
+[Book a call](https://sasateguh.com/book) · hello@sasateguh.com · [More from Sasa Teguh](https://github.com/sasateguh)

{crewforge-0.2.1 → crewforge-0.2.2}/README.md RENAMED Viewed

@@ -1,12 +1,18 @@
-# crewforge
+<p align="center"><img src="https://raw.githubusercontent.com/aimanmalib/crewforge/main/brand/logo-512.png" width="112" height="112" alt="crewforge"></p>
-**One crew of LLM agents, five recipes — code review, document Q&A, API scaffolding, content and honest academic-writing help — on any OpenAI-compatible provider, and it fails loudly instead of pretending.**
+<h1 align="center">crewforge</h1>
-[![CI](https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml/badge.svg)](https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml)
-[![PyPI](https://img.shields.io/pypi/v/crewforge)](https://pypi.org/project/crewforge/)
-[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/aimanmalib/crewforge/badge)](https://scorecard.dev/viewer/?uri=github.com/aimanmalib/crewforge)
-![Python 3.10–3.14](https://img.shields.io/badge/python-3.10%E2%80%933.14-blue)
-![License: MIT](https://img.shields.io/badge/license-MIT-green)
+<p align="center"><a href="https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml"><img src="https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://pypi.org/project/crewforge/"><img src="https://img.shields.io/pypi/v/crewforge" alt="PyPI"></a> <a href="https://scorecard.dev/viewer/?uri=github.com/aimanmalib/crewforge"><img src="https://api.scorecard.dev/projects/github.com/aimanmalib/crewforge/badge" alt="OpenSSF Scorecard"></a> <img src="https://img.shields.io/badge/python-3.10%E2%80%933.14-blue" alt="Python 3.10–3.14"> <a href="https://github.com/aimanmalib/crewforge/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"></a></p>
+<p align="center"><b>One crew of LLM agents, five recipes, any OpenAI-compatible provider.</b> · <i>Satu kru ejen LLM, lima resipi, mana-mana penyedia serasi OpenAI.</i><br>
+<a href="https://pypi.org/project/crewforge/">PyPI</a> · <a href="https://github.com/aimanmalib/crewforge/blob/main/CHANGELOG.md">changelog</a> · <a href="https://github.com/aimanmalib/crewforge/blob/main/docs/porting.md">porting notes</a> · Built in Malaysia by <a href="https://aimanmalib.com">Aiman Malib</a></p>
+crewforge is a command-line tool and Python library that runs a crew of LLM agents through five recipes: code
+review, document Q&A, API scaffolding, content writing and honest academic-writing help. It works with any
+OpenAI-compatible provider, reads API keys only from the environment, and fails loudly instead of pretending: a run
+in which an agent produced nothing exits with code 1 and names that agent.
+[Bahasa Melayu ↓](#bahasa-melayu)
 ```bash
 crewforge review src/                                  # six reviewers + a summary
@@ -23,7 +29,7 @@ crewforge academic feedback draft.md --brief brief.md --language ms
 ## Why one crew, many recipes
-crewforge started as four separate command-line tools —
+crewforge started as four separate command-line tools:
 [codeguard](https://github.com/aimanmalib/codeguard),
 [documind](https://github.com/aimanmalib/documind),
 [apiforge](https://github.com/aimanmalib/apiforge) and
@@ -37,7 +43,7 @@ showed the copies had drifted and that each hid its failures differently:
 - apiforge scored a spec with **no endpoints** 100/100;
 - contentforge wrote the real API key into its YAML file, and sent `${OPENAI_API_KEY}` literally as the key.
-crewforge keeps one core — so a fix lands once — and turns each tool into a
+crewforge keeps one core, so a fix lands once, and turns each tool into a
 *recipe*: a set of agents plus the steps that connect them. The same core rules
 apply to every recipe: non-streaming requests, bounded retries, usage numbers
 taken only from the provider, keys only from the environment, and no run that
@@ -232,13 +238,13 @@ Saya menggunakan crewforge academic (versi 0.1.0), sebuah alat berbantukan AI, d
 - 22 Oktober 2026: Perancangan: alat ini menukar taklimat tugasan (brief-ms.md) kepada 3 soalan kajian, rangka 5 bahagian dan peruntukan perkataan. ...
 ```
-How sources are labelled — there is no "verified" status, because the tool
+How sources are labelled: there is no "verified" status, because the tool
 cannot check that a source exists:
 | Source | Label |
 |---|---|
 | You supplied it | *supplied by you (not checked online)* |
-| The model proposed it, with a DOI, URL or valid ISBN | **UNVERIFIED** — check it |
+| The model proposed it, with a DOI, URL or valid ISBN | **UNVERIFIED**: check it |
 | The model proposed it with none of those | **LIKELY FABRICATED** |
 | The model added a DOI/URL/ISBN to a reference you supplied | **UNVERIFIED**, naming the added identifier |
@@ -277,16 +283,16 @@ An unknown provider name is a configuration error, not a silent fallback.
 <sub>Source: [docs/architecture.mmd](https://github.com/aimanmalib/crewforge/blob/main/docs/architecture.mmd) (re-render with `scripts/render_architecture.py`).</sub>
-- **`core/client.py`** — one async client. It always sends `"stream": false`,
+- **`core/client.py`**: one async client. It always sends `"stream": false`,
   retries only HTTP 429, 5xx and network/timeout errors (with capped exponential
   backoff that honours `Retry-After`), and fails on the first 401/403/4xx with a
   message naming the variable to fix. The key is only ever a request header.
-- **`core/agent.py`** — an agent is a role, a system prompt and per-agent
+- **`core/agent.py`**: an agent is a role, a system prompt and per-agent
   sampling defaults. `ask()` records usage and raises if the reply is blank;
   `ask_json()` additionally requires parseable JSON (optionally a pydantic schema).
-- **`core/crew.py`** — runs agents as sequential steps or parallel stages and
+- **`core/crew.py`**: runs agents as sequential steps or parallel stages and
   turns any failure into a `CrewFailedError` that lists every failed agent.
-- **`core/usage.py`** — per-agent calls, tokens, retries and latency, taken from
+- **`core/usage.py`**: per-agent calls, tokens, retries and latency, taken from
   the provider's `usage` object. Calls without usage are counted as "not reported",
   never estimated.
@@ -351,10 +357,10 @@ watching them fail; see [docs/porting.md](https://github.com/aimanmalib/crewforg
 crewforge was built with AI coding assistance (Claude Code) under the
 direction of its author, Muhammad Aiman. It consolidates four earlier tools by
-the same author — [codeguard](https://github.com/aimanmalib/codeguard),
+the same author ([codeguard](https://github.com/aimanmalib/codeguard),
 [documind](https://github.com/aimanmalib/documind),
 [apiforge](https://github.com/aimanmalib/apiforge) and
-[contentforge](https://github.com/aimanmalib/contentforge) — whose test suites
+[contentforge](https://github.com/aimanmalib/contentforge)), whose test suites
 were carried over into this repository (see [docs/porting.md](https://github.com/aimanmalib/crewforge/blob/main/docs/porting.md)
 for what was ported, re-targeted at the shared core, or dropped and why).
@@ -377,10 +383,52 @@ Please report vulnerabilities privately through
 See [SECURITY.md](https://github.com/aimanmalib/crewforge/blob/main/SECURITY.md) for scope notes (what is sent to your provider,
 and what `validate` executes).
-## License
+## Bahasa Melayu
+crewforge ialah alat baris arahan dan pustaka Python yang menjalankan satu kru ejen LLM melalui lima resipi:
+semakan kod (`review`), soal jawab dokumen (`ask`, `summarize`), penjanaan projek API FastAPI (`scaffold`,
+`validate`), penulisan kandungan (`write`) dan bantuan penulisan akademik yang jujur (`academic`). Ia berfungsi
+dengan mana-mana penyedia serasi OpenAI, termasuk model tempatan melalui Ollama atau llama.cpp. Kunci API hanya
+dibaca dari pemboleh ubah persekitaran, tidak pernah ditulis ke fail.
+**Mengapa satu kru.** crewforge menggabungkan empat alat lama (codeguard, documind, apiforge, contentforge) yang
+masing-masing menyimpan salinan sendiri bagi rangka yang sama. Salinan itu sudah berbeza dan setiap satu
+menyembunyikan kegagalan dengan cara sendiri. Kini teras dikongsi: pembaikan dibuat sekali, dan setiap alat menjadi
+resipi di atas teras itu.
+**Gagal dengan jelas.** Larian yang ejennya memulangkan jawapan kosong atau tidak boleh dihurai, atau pengesah
+yang tidak menyemak apa-apa, keluar dengan kod 1 dan menamakan ejen itu. Kod keluar: `0` berjaya, `1` larian
+gagal, `2` ralat penggunaan atau konfigurasi. Bilangan token diambil daripada laporan penyedia sahaja, tidak
+dianggar.
+**Resipi `academic`.** Membantu pelajar dan penyelidik dengan kerja mereka **sendiri**: merancang dari taklimat
+tugasan, memberi ulasan atas draf tanpa menulis semula, memformat rujukan yang diberi pengguna (APA 7, IEEE,
+Harvard) tanpa menambah rujukan baharu, dan menulis pernyataan penggunaan AI daripada rekod langkah yang
+dijalankan. Output dalam bahasa Inggeris atau Bahasa Melayu (`--language ms`); output BM disemak untuk bentuk
+Indonesia seperti *karena* atau *kualitas*. Sumber yang dicadangkan model dilabel UNVERIFIED, atau LIKELY
+FABRICATED jika tiada DOI, URL atau ISBN. Tiada ciri "humanise" atau mengelak pengesan AI.
+**Pasang dan guna.**
+```bash
+pip install crewforge                 # Python 3.10 hingga 3.14
+pip install "crewforge[docs,api]"     # pilihan: PDF/DOCX dan semakan aplikasi FastAPI
+export OPENAI_API_KEY=sk-...          # atau penyedia lain, lihat `crewforge providers`
+crewforge review src/
+crewforge academic feedback draf.md --brief taklimat.md --language ms
+```
+Senarai penyedia, contoh setiap resipi dan seni bina ada dalam bahagian bahasa Inggeris di atas
+([Providers](https://github.com/aimanmalib/crewforge#providers), [Recipes](https://github.com/aimanmalib/crewforge#recipes)).
+## Licence
+[MIT](https://github.com/aimanmalib/crewforge/blob/main/LICENSE) © Muhammad Aiman. Made by [Aiman Malib](https://aimanmalib.com), Malaysia.
+## Work with Sasa Teguh
-[MIT](https://github.com/aimanmalib/crewforge/blob/main/LICENSE) © Muhammad Aiman
+[![Work with Sasa Teguh: book a call](https://raw.githubusercontent.com/sasateguh/.github/main/assets/work-with-sasa-teguh.png)](https://sasateguh.com/book)
----
+I built this project. I run [Sasa Teguh](https://sasateguh.com), a studio in Malaysia that builds websites found on Google and in AI answers, and sets up systems like this one for businesses.
-Built by [Sasa Teguh](https://sasateguh.com) · Malaysia
+[Book a call](https://sasateguh.com/book) · hello@sasateguh.com · [More from Sasa Teguh](https://github.com/sasateguh)

{crewforge-0.2.1 → crewforge-0.2.2}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "crewforge"
-version = "0.2.1"
+version = "0.2.2"
 description = "One crew of LLM agents, five recipes: code review, document Q&A, API scaffolding, content and honest academic-writing help — on any OpenAI-compatible provider."
 readme = "README.md"
 license = "MIT"

{crewforge-0.2.1 → crewforge-0.2.2}/src/crewforge/__init__.py RENAMED Viewed

@@ -1,3 +1,3 @@
 """crewforge — one crew of LLM agents, five recipes, any OpenAI-compatible provider."""
-__version__ = "0.2.1"
+__version__ = "0.2.2"

{crewforge-0.2.1 → crewforge-0.2.2/src/crewforge.egg-info}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crewforge
-Version: 0.2.1
+Version: 0.2.2
 Summary: One crew of LLM agents, five recipes: code review, document Q&A, API scaffolding, content and honest academic-writing help — on any OpenAI-compatible provider.
 Author: Muhammad Aiman
 License-Expression: MIT
@@ -56,15 +56,21 @@ Requires-Dist: fastapi>=0.110; extra == "dev"
 Requires-Dist: httpx>=0.27; extra == "dev"
 Dynamic: license-file
-# crewforge
+<p align="center"><img src="https://raw.githubusercontent.com/aimanmalib/crewforge/main/brand/logo-512.png" width="112" height="112" alt="crewforge"></p>
-**One crew of LLM agents, five recipes — code review, document Q&A, API scaffolding, content and honest academic-writing help — on any OpenAI-compatible provider, and it fails loudly instead of pretending.**
+<h1 align="center">crewforge</h1>
-[![CI](https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml/badge.svg)](https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml)
-[![PyPI](https://img.shields.io/pypi/v/crewforge)](https://pypi.org/project/crewforge/)
-[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/aimanmalib/crewforge/badge)](https://scorecard.dev/viewer/?uri=github.com/aimanmalib/crewforge)
-![Python 3.10–3.14](https://img.shields.io/badge/python-3.10%E2%80%933.14-blue)
-![License: MIT](https://img.shields.io/badge/license-MIT-green)
+<p align="center"><a href="https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml"><img src="https://github.com/aimanmalib/crewforge/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://pypi.org/project/crewforge/"><img src="https://img.shields.io/pypi/v/crewforge" alt="PyPI"></a> <a href="https://scorecard.dev/viewer/?uri=github.com/aimanmalib/crewforge"><img src="https://api.scorecard.dev/projects/github.com/aimanmalib/crewforge/badge" alt="OpenSSF Scorecard"></a> <img src="https://img.shields.io/badge/python-3.10%E2%80%933.14-blue" alt="Python 3.10–3.14"> <a href="https://github.com/aimanmalib/crewforge/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License: MIT"></a></p>
+<p align="center"><b>One crew of LLM agents, five recipes, any OpenAI-compatible provider.</b> · <i>Satu kru ejen LLM, lima resipi, mana-mana penyedia serasi OpenAI.</i><br>
+<a href="https://pypi.org/project/crewforge/">PyPI</a> · <a href="https://github.com/aimanmalib/crewforge/blob/main/CHANGELOG.md">changelog</a> · <a href="https://github.com/aimanmalib/crewforge/blob/main/docs/porting.md">porting notes</a> · Built in Malaysia by <a href="https://aimanmalib.com">Aiman Malib</a></p>
+crewforge is a command-line tool and Python library that runs a crew of LLM agents through five recipes: code
+review, document Q&A, API scaffolding, content writing and honest academic-writing help. It works with any
+OpenAI-compatible provider, reads API keys only from the environment, and fails loudly instead of pretending: a run
+in which an agent produced nothing exits with code 1 and names that agent.
+[Bahasa Melayu ↓](#bahasa-melayu)
 ```bash
 crewforge review src/                                  # six reviewers + a summary
@@ -81,7 +87,7 @@ crewforge academic feedback draft.md --brief brief.md --language ms
 ## Why one crew, many recipes
-crewforge started as four separate command-line tools —
+crewforge started as four separate command-line tools:
 [codeguard](https://github.com/aimanmalib/codeguard),
 [documind](https://github.com/aimanmalib/documind),
 [apiforge](https://github.com/aimanmalib/apiforge) and
@@ -95,7 +101,7 @@ showed the copies had drifted and that each hid its failures differently:
 - apiforge scored a spec with **no endpoints** 100/100;
 - contentforge wrote the real API key into its YAML file, and sent `${OPENAI_API_KEY}` literally as the key.
-crewforge keeps one core — so a fix lands once — and turns each tool into a
+crewforge keeps one core, so a fix lands once, and turns each tool into a
 *recipe*: a set of agents plus the steps that connect them. The same core rules
 apply to every recipe: non-streaming requests, bounded retries, usage numbers
 taken only from the provider, keys only from the environment, and no run that
@@ -290,13 +296,13 @@ Saya menggunakan crewforge academic (versi 0.1.0), sebuah alat berbantukan AI, d
 - 22 Oktober 2026: Perancangan: alat ini menukar taklimat tugasan (brief-ms.md) kepada 3 soalan kajian, rangka 5 bahagian dan peruntukan perkataan. ...
 ```
-How sources are labelled — there is no "verified" status, because the tool
+How sources are labelled: there is no "verified" status, because the tool
 cannot check that a source exists:
 | Source | Label |
 |---|---|
 | You supplied it | *supplied by you (not checked online)* |
-| The model proposed it, with a DOI, URL or valid ISBN | **UNVERIFIED** — check it |
+| The model proposed it, with a DOI, URL or valid ISBN | **UNVERIFIED**: check it |
 | The model proposed it with none of those | **LIKELY FABRICATED** |
 | The model added a DOI/URL/ISBN to a reference you supplied | **UNVERIFIED**, naming the added identifier |
@@ -335,16 +341,16 @@ An unknown provider name is a configuration error, not a silent fallback.
 <sub>Source: [docs/architecture.mmd](https://github.com/aimanmalib/crewforge/blob/main/docs/architecture.mmd) (re-render with `scripts/render_architecture.py`).</sub>
-- **`core/client.py`** — one async client. It always sends `"stream": false`,
+- **`core/client.py`**: one async client. It always sends `"stream": false`,
   retries only HTTP 429, 5xx and network/timeout errors (with capped exponential
   backoff that honours `Retry-After`), and fails on the first 401/403/4xx with a
   message naming the variable to fix. The key is only ever a request header.
-- **`core/agent.py`** — an agent is a role, a system prompt and per-agent
+- **`core/agent.py`**: an agent is a role, a system prompt and per-agent
   sampling defaults. `ask()` records usage and raises if the reply is blank;
   `ask_json()` additionally requires parseable JSON (optionally a pydantic schema).
-- **`core/crew.py`** — runs agents as sequential steps or parallel stages and
+- **`core/crew.py`**: runs agents as sequential steps or parallel stages and
   turns any failure into a `CrewFailedError` that lists every failed agent.
-- **`core/usage.py`** — per-agent calls, tokens, retries and latency, taken from
+- **`core/usage.py`**: per-agent calls, tokens, retries and latency, taken from
   the provider's `usage` object. Calls without usage are counted as "not reported",
   never estimated.
@@ -409,10 +415,10 @@ watching them fail; see [docs/porting.md](https://github.com/aimanmalib/crewforg
 crewforge was built with AI coding assistance (Claude Code) under the
 direction of its author, Muhammad Aiman. It consolidates four earlier tools by
-the same author — [codeguard](https://github.com/aimanmalib/codeguard),
+the same author ([codeguard](https://github.com/aimanmalib/codeguard),
 [documind](https://github.com/aimanmalib/documind),
 [apiforge](https://github.com/aimanmalib/apiforge) and
-[contentforge](https://github.com/aimanmalib/contentforge) — whose test suites
+[contentforge](https://github.com/aimanmalib/contentforge)), whose test suites
 were carried over into this repository (see [docs/porting.md](https://github.com/aimanmalib/crewforge/blob/main/docs/porting.md)
 for what was ported, re-targeted at the shared core, or dropped and why).
@@ -435,10 +441,52 @@ Please report vulnerabilities privately through
 See [SECURITY.md](https://github.com/aimanmalib/crewforge/blob/main/SECURITY.md) for scope notes (what is sent to your provider,
 and what `validate` executes).
-## License
+## Bahasa Melayu
+crewforge ialah alat baris arahan dan pustaka Python yang menjalankan satu kru ejen LLM melalui lima resipi:
+semakan kod (`review`), soal jawab dokumen (`ask`, `summarize`), penjanaan projek API FastAPI (`scaffold`,
+`validate`), penulisan kandungan (`write`) dan bantuan penulisan akademik yang jujur (`academic`). Ia berfungsi
+dengan mana-mana penyedia serasi OpenAI, termasuk model tempatan melalui Ollama atau llama.cpp. Kunci API hanya
+dibaca dari pemboleh ubah persekitaran, tidak pernah ditulis ke fail.
+**Mengapa satu kru.** crewforge menggabungkan empat alat lama (codeguard, documind, apiforge, contentforge) yang
+masing-masing menyimpan salinan sendiri bagi rangka yang sama. Salinan itu sudah berbeza dan setiap satu
+menyembunyikan kegagalan dengan cara sendiri. Kini teras dikongsi: pembaikan dibuat sekali, dan setiap alat menjadi
+resipi di atas teras itu.
+**Gagal dengan jelas.** Larian yang ejennya memulangkan jawapan kosong atau tidak boleh dihurai, atau pengesah
+yang tidak menyemak apa-apa, keluar dengan kod 1 dan menamakan ejen itu. Kod keluar: `0` berjaya, `1` larian
+gagal, `2` ralat penggunaan atau konfigurasi. Bilangan token diambil daripada laporan penyedia sahaja, tidak
+dianggar.
+**Resipi `academic`.** Membantu pelajar dan penyelidik dengan kerja mereka **sendiri**: merancang dari taklimat
+tugasan, memberi ulasan atas draf tanpa menulis semula, memformat rujukan yang diberi pengguna (APA 7, IEEE,
+Harvard) tanpa menambah rujukan baharu, dan menulis pernyataan penggunaan AI daripada rekod langkah yang
+dijalankan. Output dalam bahasa Inggeris atau Bahasa Melayu (`--language ms`); output BM disemak untuk bentuk
+Indonesia seperti *karena* atau *kualitas*. Sumber yang dicadangkan model dilabel UNVERIFIED, atau LIKELY
+FABRICATED jika tiada DOI, URL atau ISBN. Tiada ciri "humanise" atau mengelak pengesan AI.
+**Pasang dan guna.**
+```bash
+pip install crewforge                 # Python 3.10 hingga 3.14
+pip install "crewforge[docs,api]"     # pilihan: PDF/DOCX dan semakan aplikasi FastAPI
+export OPENAI_API_KEY=sk-...          # atau penyedia lain, lihat `crewforge providers`
+crewforge review src/
+crewforge academic feedback draf.md --brief taklimat.md --language ms
+```
+Senarai penyedia, contoh setiap resipi dan seni bina ada dalam bahagian bahasa Inggeris di atas
+([Providers](https://github.com/aimanmalib/crewforge#providers), [Recipes](https://github.com/aimanmalib/crewforge#recipes)).
+## Licence
+[MIT](https://github.com/aimanmalib/crewforge/blob/main/LICENSE) © Muhammad Aiman. Made by [Aiman Malib](https://aimanmalib.com), Malaysia.
+## Work with Sasa Teguh
-[MIT](https://github.com/aimanmalib/crewforge/blob/main/LICENSE) © Muhammad Aiman
+[![Work with Sasa Teguh: book a call](https://raw.githubusercontent.com/sasateguh/.github/main/assets/work-with-sasa-teguh.png)](https://sasateguh.com/book)
----
+I built this project. I run [Sasa Teguh](https://sasateguh.com), a studio in Malaysia that builds websites found on Google and in AI answers, and sets up systems like this one for businesses.
-Built by [Sasa Teguh](https://sasateguh.com) · Malaysia
+[Book a call](https://sasateguh.com/book) · hello@sasateguh.com · [More from Sasa Teguh](https://github.com/sasateguh)