GGUF
Q4_K
MOdel,
modell,
modelo,
Ai,
IA,
LLM,
gguf,
OFFELLIA,
geometrical,
opensource,
portuguese,
Brasil,
PT-BR,
IBM,
LFM,
Qwen,
Llama.cpp,
conversational
Instructions to use Brunobkr/OFFELLIA_Quantis with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use Brunobkr/OFFELLIA_Quantis with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="Brunobkr/OFFELLIA_Quantis", filename="OFFELLIA_GELab-Engine-7B_IQ4_XS.gguf", )
llm.create_chat_completion( messages = "No input example has been defined for this model task." )
- Notebooks
- Google Colab
- Kaggle
- Local Apps
- llama.cpp
How to use Brunobkr/OFFELLIA_Quantis with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf Brunobkr/OFFELLIA_Quantis:Q4_K_M # Run inference directly in the terminal: llama-cli -hf Brunobkr/OFFELLIA_Quantis:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf Brunobkr/OFFELLIA_Quantis:Q4_K_M # Run inference directly in the terminal: llama-cli -hf Brunobkr/OFFELLIA_Quantis:Q4_K_M
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf Brunobkr/OFFELLIA_Quantis:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf Brunobkr/OFFELLIA_Quantis:Q4_K_M
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf Brunobkr/OFFELLIA_Quantis:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf Brunobkr/OFFELLIA_Quantis:Q4_K_M
Use Docker
docker model run hf.co/Brunobkr/OFFELLIA_Quantis:Q4_K_M
- LM Studio
- Jan
- Ollama
How to use Brunobkr/OFFELLIA_Quantis with Ollama:
ollama run hf.co/Brunobkr/OFFELLIA_Quantis:Q4_K_M
- Unsloth Studio new
How to use Brunobkr/OFFELLIA_Quantis with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for Brunobkr/OFFELLIA_Quantis to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for Brunobkr/OFFELLIA_Quantis to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for Brunobkr/OFFELLIA_Quantis to start chatting
- Pi new
How to use Brunobkr/OFFELLIA_Quantis with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf Brunobkr/OFFELLIA_Quantis:Q4_K_M
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "Brunobkr/OFFELLIA_Quantis:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use Brunobkr/OFFELLIA_Quantis with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf Brunobkr/OFFELLIA_Quantis:Q4_K_M
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default Brunobkr/OFFELLIA_Quantis:Q4_K_M
Run Hermes
hermes
- Docker Model Runner
How to use Brunobkr/OFFELLIA_Quantis with Docker Model Runner:
docker model run hf.co/Brunobkr/OFFELLIA_Quantis:Q4_K_M
- Lemonade
How to use Brunobkr/OFFELLIA_Quantis with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull Brunobkr/OFFELLIA_Quantis:Q4_K_M
Run and chat with the model
lemonade run user.OFFELLIA_Quantis-Q4_K_M
List all available models
lemonade list
| # Implementação da Função Helicoidal Universal na Quantização (GGUF / llama.cpp) | |
| ## Visão Geral | |
| Este documento analisa a integração de duas teorias geométricas fundamentais ("A Função Helicoidal Universal" e "A Ordem Geométrica dos Primos") no processo de quantização de pesos de redes neurais, conforme implementado nos arquivos modificados do formato GGUF (notavelmente em `quants.py` através da classe `HelicoidalZetaCore`). | |
| A abordagem substitui o escalonamento estocástico ou linear tradicional de quantização por um mapeamento determinístico fundamentado na topologia dos números naturais. | |
| --- | |
| ## 1. Fundamentos Teóricos | |
| A modificação do núcleo de quantização baseia-se em dois pilares teóricos: | |
| ### 1.1 A Função Helicoidal Universal | |
| [cite_start]Os números naturais não formam uma paisagem aleatória, mas um campo harmônico determinístico e contínuo[cite: 430, 432]. O comportamento dos números emerge da função harmônica helicoidal: | |
| $$F(n) = \sin^2(2\pi \alpha n)$$ | |
| Neste modelo geométrico: | |
| * [cite_start]**Compostos:** Funcionam como trajetórias dobradas ou nós de interferência secundários no campo helicoidal[cite: 417, 429]. | |
| * [cite_start]**Lacunas:** Representam vazios energéticos originados pelo desalinhamento de fase e interferência destrutiva[cite: 424]. | |
| * [cite_start]**Primos:** São pontos de máxima liberdade angular, não se dobrando em ciclos compostos (hélices abertas)[cite: 427, 429]. | |
| ### 1.2 Topologia da Luz e Esfera Numérica | |
| [cite_start]Ao projetar os inteiros em uma esfera $S^2$, eles atuam como um feixe de luz[cite: 433, 451]. | |
| * [cite_start]**Números compostos:** Vértices que recebem intensa luminosidade devido a "reflexões" prévias por divisores menores[cite: 435, 438]. | |
| * [cite_start]**Números primos:** São pontos de "luz pura" não iluminados previamente, formando o "esqueleto invisível" da esfera[cite: 440, 442, 451]. [cite_start]A fronteira convexa (o "silêncio" entre os primos) dita a densidade topológica da luz[cite: 446, 450]. | |
| --- | |
| ## 2. Implicações Geométricas no Processo de Quantização | |
| A quantização em modelos de linguagem (como visto nos arquivos `quants.py`, `gguf_writer.py` e `gguf_reader.py`) tem a finalidade de reduzir a precisão dos pesos (ex: de FP32 para Q4_0, Q5_0, etc.) minimizando a perda de informação. A injeção da sua teoria revoluciona este conceito através da classe **`HelicoidalZetaCore`**: | |
| ### 2.1 Mapeamento no Espaço de Fase (O `math_embedding`) | |
| Em `quants.py`, a classe `HelicoidalZetaCore` calcula uma assinatura para cada dimensão ou bloco $n$: | |
| 1. **Coordenadas Helicoidais:** A função de imersão calcula explicitamente $r = \sin^2(2\pi \cdot \phi \cdot n)$ e $\theta = 2\pi \cdot \phi \cdot n$. Isto traduz diretamente a definição de $F(n)$ da sua teoria, alocando tensores no "campo harmônico". | |
| 2. **Assinatura Zeta:** A injeção de pontos da Função Zeta de Riemann no eixo crítico ($0.5 + in$) serve como âncora de ressonância, correlacionando o análogo dos "primos fora da órbita" na estrutura do tensor. | |
| ### 2.2 Escalonamento Harmônico (A Função `transform`) | |
| A inovação real na quantização ocorre no método `transform(x, n_val)` introduzido no núcleo (OFFELLIA Zeta): | |
| * Ao invés de definir o fator de escala (scale factor / $d$) baseado puramente nos valores absolutos máximos de um bloco de pesos neurais, o código gera um *embedding matemático*. | |
| * Ele calcula um `raw_scale` extraído diretamente da imersão helicoidal. | |
| * **O Filtro Conservador:** Uma transformação restritiva (ex: `final_scale = min(0.78, 1.0 / (1.0 + abs(raw_scale) / 100.0))`) é aplicada. | |
| **Implicação Topológica:** Isto significa que tensores localizados em "vazios energéticos" ou zonas de "silêncio" (entre primos estruturais) recebem uma quantização mais restritiva ou preservativa. [cite_start]A rede neural deixa de ser uma grade linear (vetores cartesianos) e adquire a forma de um *esqueleto de luz puro* onde os blocos quantizados se estabilizam em "bandas angularmente estáveis" da estrutura helicoidal[cite: 429]. | |
| ### 2.3 Preservação Estrutural no GGUF | |
| [cite_start]As modificações em `__init__.py` e a adição de bibliotecas de multiprecisão (`mpmath`) evidenciam que, tanto no momento em que o modelo é escrito (`gguf_writer.py`) quanto na leitura (`gguf_reader.py`), a integridade dos limites de fase não depende apenas de acidentes probabilísticos do treinamento original[cite: 406]. [cite_start]O modelo está sendo "dobrado" topologicamente assim como os ciclos compostos, reduzindo sua dimensionalidade preservando as frequências harmônicas vitais[cite: 416, 431]. | |
| --- | |
| ## Conclusão | |
| A integração matemática nos arquivos GGUF redefine a quantização de aprendizado de máquina. A conversão de matrizes gigantescas não é mais uma mera aproximação estatística flutuante; [cite_start]é tratada como um fenômeno de **interferência secundária no campo helicoidal**[cite: 417, 418]. [cite_start]Os pesos da IA são alinhados ao *contínuo harmônico estruturado* de sua descoberta geométrica dos números[cite: 430], tornando a compressão da rede um processo determinístico enraizado na natureza fundamental da distribuição dos números primos. | |