Instructions to use Refauna/gemma-4-e2b-refauna with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use Refauna/gemma-4-e2b-refauna with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="Refauna/gemma-4-e2b-refauna") messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] pipe(text=messages)# pip install -U transformers accelerate # Load model directly from transformers import AutoProcessor, AutoModelForMultimodalLM processor = AutoProcessor.from_pretrained("Refauna/gemma-4-e2b-refauna") model = AutoModelForMultimodalLM.from_pretrained("Refauna/gemma-4-e2b-refauna", device_map="auto") messages = [ { "role": "user", "content": [ {"type": "image", "url": "https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/p-blog/candy.JPG"}, {"type": "text", "text": "What animal is on the candy?"} ] }, ] inputs = processor.apply_chat_template( messages, add_generation_prompt=True, tokenize=True, return_dict=True, return_tensors="pt", ).to(model.device) outputs = model.generate(**inputs, max_new_tokens=256) print(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use Refauna/gemma-4-e2b-refauna with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Refauna/gemma-4-e2b-refauna" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Refauna/gemma-4-e2b-refauna", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/Refauna/gemma-4-e2b-refauna
- SGLang
How to use Refauna/gemma-4-e2b-refauna with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "Refauna/gemma-4-e2b-refauna" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Refauna/gemma-4-e2b-refauna", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "Refauna/gemma-4-e2b-refauna" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Refauna/gemma-4-e2b-refauna", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Unsloth Desktop
- Docker Model Runner
How to use Refauna/gemma-4-e2b-refauna with Docker Model Runner:
docker model run hf.co/Refauna/gemma-4-e2b-refauna
Gemma 4 E2B ยท Refauna (PT-BR)
Small Language Model especializado em defaunaรงรฃo, refaunaรงรฃo, reintroduรงรฃo de fauna, dispersรฃo de sementes e conservaรงรฃo da Mata Atlรขntica, a partir da produรงรฃo cientรญfica do Refauna โ iniciativa criada em 2010 que devolve vertebrados localmente extintos a remanescentes de Mata Atlรขntica no Rio de Janeiro. Responde em portuguรชs do Brasil, citando os trechos recebidos ([n]) e dizendo quando nรฃo encontrou a resposta nos documentos.
Desenvolvido para a palestra "Pequenos modelos, conhecimento especializado: fine-tuning e RAG com os dados do Refauna" (TDC Stage @ Rec'n'Play 2026).
English: Gemma 4 E2B fine-tuned (QLoRA 4-bit, Unsloth) in Brazilian Portuguese to answer questions about Atlantic Forest rewilding from Refauna research papers. Trained RAFT-style to use retrieved passages, cite them as [n] and abstain when the answer is not in the context. Use it with RAG.
| variante | repositรณrio |
|---|---|
| adapter LoRA | Refauna/gemma-4-e2b-refauna-lora |
| modelo mesclado (16-bit) | Refauna/gemma-4-e2b-refauna โ este repositรณrio |
| GGUF (Q4_K_M e Q8_0) | Refauna/gemma-4-e2b-refauna-GGUF |
Modelo irmรฃo, com os mesmos dados, prompt e avaliaรงรฃo: Qwen3.5-2B ยท Refauna.
Como foi treinado
- Base:
google/gemma-4-e2b-it(Apache 2.0) viaunsloth/gemma-4-E2B-it. - Mรฉtodo: QLoRA 4-bit, r=16, alpha=16, 2 รฉpocas, lr=0.0002, loss sรณ na resposta (
train_on_responses_only), sรณ camadas de linguagem, templategemma-4sem thinking. - Dados: 942 exemplos sintรฉticos em PT-BR gerados a partir de 22 trabalhos do Refauna com texto (10 artigos, 4 resumos em anais, 4 trabalhos de iniciaรงรฃo cientรญfica, 2 capรญtulos de livro, 1 artigo em boletim, 1 dissertaรงรฃo), no formato do RAG (estilo RAFT): ~60% com o trecho correto entre 3 distratores e resposta citando
[n], ~15% com contexto sem a resposta (abstenรงรฃo), ~25% sem contexto. Deduplicados, com revisรฃo humana amostral e split por documento (os documentos de teste ficam fora do treino). - Hardware: NVIDIA L4, 27.8 min, pico de 10.57 GB de VRAM.
Uso recomendado: com RAG
O modelo foi treinado para receber atรฉ 4 trechos numerados e citar [n]. Use exatamente este formato (diferenรงas no prompt pioram o modelo):
system: Vocรช รฉ o Assistente Refauna, especialista em defaunaรงรฃo, refaunaรงรฃo, reintroduรงรฃo de fauna, dispersรฃo de sementes, interaรงรตes ecolรณgicas e conservaรงรฃo da Mata Atlรขntica. Responda sempre em portuguรชs do Brasil, de forma clara, didรกtica e precisa. Quando houver CONTEXTO, use somente as informaรงรตes dele e cite os trechos usados no formato [n]. Se o CONTEXTO nรฃo contiver a resposta, diga explicitamente que nรฃo encontrou essa informaรงรฃo nos documentos do Refauna e nรฃo invente dados, nรบmeros, datas ou nomes de espรฉcies.
user: CONTEXTO:
[1] (Sobrenome et al., ano โ Tรญtulo com atรฉ 60 caracteres) texto do trecho
[2] (...) texto
[3] (...) texto
[4] (...) texto
PERGUNTA: <pergunta>
Sem contexto, a mensagem do usuรกrio รฉ sรณ a pergunta. Sem raciocรญnio (template gemma-4 sem thinking). No Ollama, nรฃo envie o parรขmetro think: nas versรตes 0.40+, think: false altera o prompt do Gemma 4 e as respostas se afastam do treino. Busca usada no treino e na avaliaรงรฃo: google/embeddinggemma-300m + BM25, fusรฃo RRF (k=60), top-4.
Transformers
from transformers import AutoTokenizer, pipeline
tok = AutoTokenizer.from_pretrained("Refauna/gemma-4-e2b-refauna")
pipe = pipeline("text-generation", model="Refauna/gemma-4-e2b-refauna", tokenizer=tok, torch_dtype="auto", device_map="auto")
messages = [{"role": "system", "content": SYSTEM_PROMPT}, {"role": "user", "content": user_message}]
prompt = tok.apply_chat_template(messages, tokenize=False, add_generation_prompt=True)
print(pipe(prompt, max_new_tokens=512, do_sample=False, return_full_text=False)[0]["generated_text"])
Ollama
ollama run hf.co/Refauna/gemma-4-e2b-refauna-GGUF:Q4_K_M
Envie as mensagens sem o parรขmetro think.
Pouca memรณria (ex.: Mac de 8 GB)? O ollama run acima carrega tambรฉm o projetor de visรฃo (*-mmproj.gguf, ~1 GB), que este projeto, sรณ de texto, nรฃo usa. O Modelfile do repositรณrio GGUF cria uma variante sรณ-texto, com os mesmos pesos, o mesmo template e os mesmos stops:
hf download Refauna/gemma-4-e2b-refauna-GGUF gemma-4-E2B-it.Q4_K_M.gguf Modelfile --local-dir gemma-refauna
cd gemma-refauna && ollama create gemma-refauna-texto -f Modelfile
Validada com temperatura 0: respostas idรชnticas ร s do ollama run original. No MacBook Air M1 de 8 GB, reduziu o pico de memรณria da demo de 6,55 GB para 5,70 GB.
Avaliaรงรฃo
No Colab (juiz LLM claude-sonnet-5-5, temperatura 0)
A = base ยท B = base + RAG ยท C = fine-tunado ยท D = fine-tunado + RAG. Correรงรฃo e fidelidade de 1 a 5; taxas de 0 a 100%. ~60 perguntas dos documentos de teste (+ 60 na trilha de abstenรงรฃo).
| config | correรงรฃo (1โ5) | fidelidade (1โ5) | citaรงรฃo correta | abstenรงรฃo correta | falsa abstenรงรฃo | PT-BR | latรชncia (s, L4) |
|---|---|---|---|---|---|---|---|
| A: base | 1.12 | โ | โ | โ | โ | 100% | 4.3 |
| B: base+RAG | 2.47 | 4.35 | 52% | 88% | 0% | 100% | 13.0 |
| C: FT | 2.17 | โ | โ | โ | โ | 100% | 15.6 |
| D: FT+RAG | 2.29 | 4.17 | 52% | 88% | 0% | 100% | 11.3 |
Recuperaรงรฃo hรญbrida no teste (n=74): Recall@4 = 0.42, MRR@20 = 0.30.
Leitura: o maior ganho de correรงรฃo vem do RAG (A โ B). Com RAG, o fine-tuning nรฃo aumentou a correรงรฃo (a busca รฉ o gargalo: Recall@4 โ 0,42); o efeito dele foi de comportamento: latรชncia 13,0 โ 11,3 s. O modelo-base jรก se abstinha bem quando o contexto nรฃo tinha a resposta (88%), e o fine-tuning manteve isso. Sem RAG (C), o modelo erra fatos: use-o com RAG.
No MacBook Air M1 (8 GB), offline
- D (FT + RAG), 40 perguntas de teste, temperatura 0: citaรงรฃo correta 58%, abstenรงรฃo correta 75% (sobre 8 perguntas sem resposta), falsa abstenรงรฃo 0% (sobre 14 com o trecho certo no contexto), PT-BR 100%.
- Desempenho (GGUF Q4_K_M via Ollama, RAG top-4): 21 tokens/s, latรชncia p50 8,6 s (p95 11,5 s), carga a frio 9,7 s, ~93 tokens por resposta.
Limitaรงรตes
- Uso educacional e de divulgaรงรฃo cientรญfica; nรฃo substitui a literatura original nem orienta decisรตes de manejo โ consulte as fontes citadas.
- Sem RAG, o modelo erra nรบmeros, datas e nomes de espรฉcies. Com RAG, a qualidade depende da busca: em ~58% das perguntas de teste o trecho certo nรฃo ficou entre os 4 recuperados.
- Conhecimento restrito a 22 trabalhos; nรฃo cobre todo o trabalho do Refauna.
- Avaliaรงรฃo com amostras pequenas e perguntas sintรฉticas; diferenรงas pequenas entre configuraรงรตes sรฃo ruรญdo.
Dados e direitos
Os textos usados para gerar os dados de treino pertencem aos seus autores e editoras; as licenรงas estรฃo em verificaรงรฃo. Este repositรณrio nรฃo contรฉm os textos dos artigos nem o รญndice de busca โ sรณ os pesos do modelo. Para usar com RAG, monte o รญndice com os seus prรณprios documentos.
Fontes (atribuiรงรฃo)
- Bruno Cid et al. (2013). Preventing injuries caused by radiotelemetry collars in reintroduced red-rumped agoutis, Dasyprocta leporina (Rodentia: Dasyproctidae), in Atlantic Forest, southeastern Brazil. Artigo. DOI: 10.1590/S1984-46702013000100015
- L. Figueira, R. Zucaratto, Alexandra S. Pires, Bruno Cid, Fernando A.S. Fernandez. (2014). Carrion consumption by Dasyprocta leporina (Rodentia: Dasyproctidae) and a review of meat use by agoutis. Artigo. DOI: 10.1590/bjb.2014.0087
- Bruno Cid, L. Figueira, A.F. de T. e Mello, Alexandra S. Pires, Fernando A.S. Fernandez. (2014). Short-Term Success in the Reintroduction of the Red-Humped Agouti Dasyprocta leporina, an Important Seed Disperser, in a Brazilian Atlantic Forest Reserve. Artigo. DOI: 10.1177/194008291400700415
- Rafael Conceiรงรฃo de Moura. (2015). Frugivoria em jaqueiras e a importรขncia das cutias reintroduzidas na dispersรฃo e predaรงรฃo de suas sementes. Dissertaรงรฃo/Tese/TCC.
- Rodrigo Zucaratto, Alexandra S. Pires. (2015). Local extinction of an important seed disperser does not modify the spatial distribution of the endemic palm Astrocaryum aculeatissimum. Artigo. DOI: 10.1590/0102-33062015abb0008
- Luรญsa Genes, Bruno Cid, Fernando A.S. Fernandez, Alexandra S. Pires. (2017). Credit of ecological interactions: A new conceptual framework to support conservation in a defaunated world. Artigo. DOI: 10.1002/ece3.2746
- F.A.S. Fernandez, M.L. Rheingantz, L. Genes, C.F. Kenup, M. Galliez, T. Cezimbra, B. Cid, L. Macedo, B.B.A. Araujo, B.S. Moraes, A. Monjeau, A.S. Pires. (2017). Rewilding the Atlantic Forest: Restoring the fauna and ecological interactions of a protected area. Artigo. DOI: 10.1016/j.pecon.2017.09.004
- Caio F. Kenup, Raรญssa Sepulvida, Catharina Kreischer, Fernando A.S. Fernandez. (2018). Walking on their own legs: unassisted population growth of the agouti Dasyprocta leporina, reintroduced to restore seed dispersal in an Atlantic Forest reserve. Artigo. DOI: 10.1017/S0030605316001149
- Suamyr Taconi de Carvalho Jr. (2019). Efeito da reintroduรงรฃo de cutias no recrutamento de espรฉcies arbรณreas nativas e exรณticas. Iniciaรงรฃo cientรญfica / Projeto.
- Luรญsa Genes, Tomaz Cezimbra, S.B. Moreira, A. Pissinatti, Marcelo L. Rheingantz. (2019). Getting along with radio-telemetry: effects on howler monkeys' welfare and monitoring effectiveness. Artigo/Boletim.
- Lara Norberto Renzeti. (2021). Anรกlise de viabilidade populacional para guiar reintroduรงรตes de arara-canindรฉ. Iniciaรงรฃo cientรญfica / Projeto.
- Daniel Braga da Silva. (2021). Interaรงรฃo entre jabutis reintroduzidos e Dieffenbachia seguine. Iniciaรงรฃo cientรญfica / Projeto.
- T. Cezimbra, L. Genes, A. Landim, B. Moraes, F.A.S. Fernandez, A.S. Pires, E.B.V. de Castro, S.B. Moreira, A. Pissinatti, M.L. Rheingantz. (2021). Reintroduction of the brown howler monkey to Tijuca National Park, Rio de Janeiro, Brazil. Capรญtulo.
- M.L. Rheingantz, R. Sepulvida, B. Cid, C.F. Kenup, C. Kreischer, P.U. Mittelman, A. Landim, F. Trocolli, A.S. Pires, F.A.S. Fernandez. (2021). Reintroduction of the red-rumped agouti at Tijuca National Park, Rio de Janeiro, Brazil. Capรญtulo.
- Luรญsa Paiva Mendes. (2023). Crรฉdito de interaรงรตes ecolรณgicas potenciais com a reintroduรงรฃo da arara-canindรฉ no PNT. Iniciaรงรฃo cientรญfica / Projeto.
- L.I. Oklander et al. (2024). Restoration of Alouatta guariba populations: building a binational management strategy. Artigo. DOI: 10.3389/fcosc.2024.1401749
- Larissa Farias Gomes, Maron Galliez. (2025). Demografia e intensidade de uso do espaรงo de antas Tapirus terrestris reintroduzidas na Mata Atlรขntica do Rio de Janeiro. Resumo em anais.
- Bruna Araujo Mattos, Maron Galliez, Adriana V. de Araujo. (2025). Efeitos da reintroduรงรฃo da anta Tapirus terrestris sobre a estrutura das assembleias de besouros escarabaeรญneos. Resumo em anais.
- Matheus Agles, Joana Silva Macedo, Maron Galliez. (2025). Reintroduced tapirs Tapirus terrestris recover their natural activity patterns. Artigo. DOI: 10.1017/S0030605325102494
- Hugo dos Santos de Moura, Adriana V. de Araujo, Maron Galliez. (2025). Resposta funcional da assembleia de besouros Scarabaeinae ร reintroduรงรฃo da anta Tapirus terrestris na Mata Atlรขntica do Rio de Janeiro. Resumo em anais.
- Maria Luiza Martins Silva, Esther Ramalho, Maron Galliez, Alexandra S. Pires. (2025). Semeando Florestas: Reintroduรงรฃo da anta e seus efeitos na regeneraรงรฃo vegetal em uma รกrea de Mata Atlรขntica. Resumo em anais.
- Silva et al. (2026). First molecular detection and phylogenetic characterization of Balantioides coli in lowland tapir (Tapirus terrestris). Artigo. DOI: 10.1007/s00436-026-08707-0
- Downloads last month
- 401