Instructions to use Fernandosr85/cordelbr-grounded-adapter with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- PEFT
How to use Fernandosr85/cordelbr-grounded-adapter with PEFT:
Task type is invalid.
- Notebooks
- Google Colab
- Kaggle
CordelBR-Grounded — Factually-Verified Brazilian Cordel Poetry Adapter
LoRA adapter fine-tuned on Mixtral-8x7B-Instruct-v0.1 (46.7B total / 12.9B active parameters, sparse mixture-of-experts) for closed-book, factually-grounded generation of traditional Brazilian cordel poetry, via Adaption's AutoScientist platform.
The problem this adapter addresses
General-purpose LLMs asked to write culturally-grounded poetry from a source text routinely do one of two things under rhyme and meter pressure: invent plausible-sounding facts not present in the source, or distort real facts, institutional names, and grammar to force a rhyme. Given the same source text about the Feira de Caruaru, an ungrounded model might:
truncate an official name to fit the meter — writing "Livro de Lugar" when the source says "Livro de Registro de Lugar" — or bend a real word out of its natural sense to close a rhyme, e.g. forcing "centavo" ("cent") into a line about a river sustaining "vida e agricultura" ("life and agriculture") just because it rhymes with "bravo".
This adapter is trained to extract only facts explicitly present in a given source, preserve official institutional names in full, and rewrite the rhyme scheme rather than distort meaning when a natural rhyme isn't available.
Training metrics
| Metric | Value |
|---|---|
| Base model | mistralai/Mixtral-8x7B-Instruct-v0.1 (46.7B total / 12.9B active) |
| Trained model name | adaption_mixtral_8x7b_instruc_cordel_factual_nordeste |
| Training method | SFT + LoRA |
| LoRA rank (r) | 64 |
| LoRA alpha | 128 |
| LoRA dropout | 0 |
| Trainable modules | all-linear |
| Epochs | 5 |
| Learning rate | 5e-5 (cosine scheduler, 0.5 cycles) |
| Warmup ratio | 0.05 |
| Weight decay | 0 |
| Max grad norm | 1 |
| Dataset size | 10 examples (fidelity-gated) |
AutoScientist evaluation
| Metric | Base | Adapted |
|---|---|---|
| Win rate — on this dataset | 40 | 60 |
| Win rate — Writing, Editing & Communication category (all tasks) | 44 | 56 |
The category-wide result (+12 points, ~27% relative improvement) is the more robust figure — measured across the full category's held-out tasks, not just this dataset's 10 rows.
Dataset
| Platform | Link |
|---|---|
| Kaggle Dataset | cordelbr-grounded-verified-brazilian-cordel |
| HuggingFace Dataset | Fernandosr85/adaption-cordel-factual-nordeste |
| Kaggle Notebook | cordelbr-grounded |
10 instruction/output pairs across 4 institutional sources:
| Source | Theme | Institution |
|---|---|---|
| Caatinga e Rio São Francisco | Biome & territory | ICMBio |
| Feira de Caruaru | Intangible cultural heritage | IPHAN |
| Frevo | Music & carnival tradition | IPHAN |
| Lampião e Maria Bonita | Cangaço history | Fundação Joaquim Nabuco |
Verification pipeline (6 stages)
| Stage | Checks |
|---|---|
| 1 | Required-fact coverage against the source text (100% required) |
| 2 | Named-entity coverage against the source text (100% required) |
| 3 | Meter and rhyme scoring (redondilha maior, ABCBDB — tracked, non-gating) |
| 4 | Word-fabrication check (Portuguese dictionary + corpus vocabulary allowlist) |
| 5 | Gender/number agreement check |
| 6 | Cross-family semantic judge (GPT-4o, independent of the Claude generator) flagging real words used outside their natural sense |
Candidates falling short went through a validator-guided repair loop before re-evaluation.
Institutional sources
- IPHAN — Dossiê Feira de Caruaru: http://portal.iphan.gov.br/uploads/ckfinder/arquivos/Dossie_feira_de_caruaru.pdf
- IPHAN — Frevo, Patrimônio Cultural da Humanidade: http://portal.iphan.gov.br/noticias/detalhes/767/frevo-pernambucano-e-patrimonio-da-humanidade
- ICMBio — Bioma Caatinga: https://www.gov.br/icmbio/pt-br/assuntos/biodiversidade/unidade-de-conservacao/unidades-de-biomas/caatinga
- Lampião e Maria Bonita — história do cangaço (synthesis of public data attributed to Fundação Joaquim Nabuco): https://www.todadisciplina.com.br/lampiao/
Credits
- Fine-tuning platform: Adaption — AutoScientist & Adaptive Data
- Challenge: AutoScientist Challenge 2026
- Training infrastructure: Adaption compute credits
- Data preparation: Deduplicated via Adaption Adaptive Data (Prompt Deduplication recipe); trained on the pipeline's
Original completion— Adaption'sEnhancedremastering was measured to reduce quality by -11.3% in testing and was not used. - Author: Fernando Rodrigues · Kaggle: fernandosr85 · HuggingFace: Fernandosr85
Disclaimer
Experimental research artifact submitted to AutoScientist Challenge 2026 (Language category). This release covers 4 of 8 planned institutional sources; the remaining 4 (Maracatu Nação, Padre Cícero, Guerra de Canudos, Luiz Gonzaga) are in the source corpus and generation pipeline but had not yet cleared the fidelity gate at time of release. One source in this release (Lampião e Maria Bonita) covers a historically violent episode, presented per documented tone guidance — no glorification of violence, no graphic detail, historical ambiguity preserved rather than resolved. Outputs should be reviewed by a Portuguese-language poet or cultural expert before public or educational use.
- Downloads last month
- -
Model tree for Fernandosr85/cordelbr-grounded-adapter
Base model
mistralai/Mixtral-8x7B-v0.1