Instructions to use guifav/caramelo with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use guifav/caramelo with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="guifav/caramelo") 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)# Load model directly from transformers import AutoProcessor, AutoModelForMultimodalLM processor = AutoProcessor.from_pretrained("guifav/caramelo") model = AutoModelForMultimodalLM.from_pretrained("guifav/caramelo") 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=40) print(processor.decode(outputs[0][inputs["input_ids"].shape[-1]:])) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use guifav/caramelo with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "guifav/caramelo" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "guifav/caramelo", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/guifav/caramelo
- SGLang
How to use guifav/caramelo 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 "guifav/caramelo" \ --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": "guifav/caramelo", "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 "guifav/caramelo" \ --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": "guifav/caramelo", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }' - Docker Model Runner
How to use guifav/caramelo with Docker Model Runner:
docker model run hf.co/guifav/caramelo
Caramelo 3.4.2
Um assistente de IA brasileiro com a voz do Gui. É o Gemma 3 4B da Google com um fine-tune LoRA no estilo de escrita de Guilherme Favaron (guifav.github.io): direto ao ponto, argumentando com dados e exemplos, em português do Brasil, sem hype e sem emoji.
Versão 3.4.2 — o esquema é
caramelo {geração-Gemma}.{tamanho-B}.{iteração}:3.4é a base (Gemma 3, 4B) e.2é a segunda iteração do fine-tune. Estes pesos são o decoder de texto do Gemma 3 4B (as capacidades de visão da base não estão incluídas).
Como ele se compara ao Gemma base
Medimos em três eixos, sempre contra o Gemma 3 4B base.
1. Voz e estilo — o Caramelo ganha com folga
Em comparação A/B cega (juízes GLM-5.2 e Codex, mesma persona e amostragem, n=24 prompts fora do treino), o Caramelo é o preferido:
2. Raciocínio — preservado
O fine-tune de estilo não degradou o raciocínio neste benchmark. No ENEM (múltipla escolha, n=1432, acertos):
| modelo | ENEM |
|---|---|
| Gemma 3 4B base | 57.2% |
| Caramelo 3.4.2 | 57.5% |
Trocamos a voz sem perder o raciocínio.
3. Conversa geral — o tradeoff de concisão, mitigado
Em tarefas diversas (código, matemática, extração, explicações), a concisão do estilo do Gui chegava a custar utilidade: o modelo respondia certo, mas curto demais para o que a tarefa pedia. Uma instrução de completude na persona — aplicada server-side pelo gateway, sem retreinar — recuperou a utilidade mantendo a voz:
Uso
from transformers import pipeline
pipe = pipeline("text-generation", model="guifav/caramelo", torch_dtype="bfloat16", device_map="auto")
msgs = [{"role": "user", "content": "me explica RAG em duas frases"}]
print(pipe(msgs, max_new_tokens=300)[0]["generated_text"][-1]["content"])
Sem o pipeline, aplique o chat template com tokenizer.apply_chat_template. Ou use a API compatível com OpenAI em ia-caramelo.com, ou a CLI: npm i -g caramelo-chat e caramelo login (loga e cria a chave no terminal).
Como foi treinado
- Base:
google/gemma-3-4b-it. - Dataset (~414 pares
pergunta → resposta no estilo do Gui): construído por correção de estilo — prompts diversos em 8 domínios → rascunho do Gemma base → reescrita no estilo do Gui (ancorada em trechos reais dos artigos) → filtro por marcadores de estilo. - Método: QLoRA 4-bit (r=16, alpha=32), 3 épocas.
- A iteração anterior (3.4.1), treinada nos artigos crus, regrediu vs base — virava "intro de artigo" em vez de responder. A 3.4.2 corrige isso com dados conversacionais.
Segurança
Estes pesos são o modelo de estilo. A camada de segurança do Caramelo (recusa de conteúdo perigoso) é aplicada server-side pelo gateway em ia-caramelo.com e não está embutida nestes pesos. Além disso, o fine-tune de estilo pode ter enfraquecido os guardrails residuais do Gemma base. Não use sem moderação própria. Uso proibido: ver a política do Gemma.
Licença
Herda os termos de uso do Gemma (Google). Ao redistribuir os pesos, inclua a atribuição ao Gemma e a política de uso proibido.
Créditos
Desenvolvido, treinado e mantido por Guilherme Favaron — guifav.github.io · guilhermefavaron.com.br.
- Downloads last month
- 14

