Skip to main content
Gemma는 Google DeepMind의 오픈 가중치 모델 제품군입니다. Gemma 4 는 현재 세대로, 텍스트, 이미지, 그리고 가장 작은 크기에서는 오디오도 처리하는 멀티모달이며, 140개 이상의 언어를 지원하고, 엣지 크기부터 데스크톱 GPU 크기까지의 밀집(dense) 및 혼합 전문가(MoE) 모델로 제공됩니다. Gemma 3 는 이전 세대이지만 여전히 널리 사용되며, 특히 온디바이스 및 CPU 전용 작업을 위한 소형 모델(270m, 1b)에서 두드러집니다. 하드웨어에 맞는 모델을 로컬에서 실행한 다음, Tokios 커넥터를 연결하면 https://api.tokios.com를 통해 어떤 머신, 팀원, 또는 호스팅된 에이전트에서도 호출할 수 있습니다. 인바운드 포트나 VPN이 필요 없습니다.

Ollama로 로컬에서 실행하세요

두 세대 모두 Ollama 라이브러리에 있습니다. Gemma 4의 경우 기본 태그(즉 E4B 엣지 모델)를 가져와서 실행하세요.
데스크톱 GPU 등급의 경우 ollama run gemma4:12b, ollama run gemma4:26b (MoE) 또는 ollama run gemma4:31b을 실행하세요. 이전 세대의 경우 ollama run gemma3는 4b 기본값을 실행합니다 — 전체 태그 목록은 gemma4 및 gemma3 라이브러리 페이지를 참조하세요 — 이 페이지는 런타임 세부 사항 전부가 아닌 연결 방법을 다룹니다.
Ollama의 기본 컨텍스트 창은 작습니다 (2048 토큰) — Gemma의 기본 128K–256K보다 훨씬 낮습니다. 더 많은 컨텍스트를 사용하려면 Modelfile이나 클라이언트 요청에서 num_ctx를 높이세요.

변형 및 태그

아래의 모든 값은 모델 카드와 Ollama 라이브러리에서 가져온 것입니다. 태그와 다운로드 크기는 새로운 양자화가 출시됨에 따라 변경됩니다 — 하나로 표준화하기 전에 ollama.com/library/gemma4 및 ollama.com/library/gemma3에서 확인하세요. 출처: ollama.com/library/gemma4, ollama.com/library/gemma3, google/gemma-4-31B-it, google/gemma-4-26B-A4B-it, google/gemma-4-E4B-it, google/gemma-4-12B-it.
The 26B-A4B is a mixture-of-experts model with only about 4B active parameters per token (8 of 128 experts routed, plus 1 shared expert), so it decodes much faster than its 26B total suggests — but all 26B parameters still have to fit in memory. Don’t size your GPU off the active-parameter count alone. See how inference works for why.

양자화 및 형식

Ollama’s default tags are GGUF Q4_K_M. The gemma4 library also publishes -it-qat (quantization-aware-trained int4), -q8_0, -bf16, -mlx (Apple Silicon), -mxfp8, and -nvfp4 (NVIDIA Blackwell) variants for each size. Which format you can run depends on your hardware — see Quantization formats and the hardware they need for the full matrix, and what quantization is for how to read the Q4_K_M-style names.
QAT (quantization-aware training). Gemma 4’s -it-qat tags are int4 checkpoints Google trained to stay accurate at 4-bit, so they hold quality better than a plain post-training Q4 quant — at a comparable or smaller download: gemma4:12b-it-qat is ~7.2 GB (vs ~7.6 GB for Q4_K_M), and gemma4:e4b-it-qat is ~6.1 GB (vs ~9.6 GB). If you’re running Gemma 4 at 4-bit, prefer the -it-qat tag. See quantization-aware training for how it works.

하드웨어 요구 사항 — Gemma 4가 GPU에 맞을까요?

적당한 컨텍스트 길이에서 대략 Q4 정도면 충분합니다. 각 항목을 추정치로 취급하세요. 실제 기준은 실제 GGUF 크기에 해당 컨텍스트의 KV 캐시를 더한 값입니다. 크기 계산은 어떤 크기의 모델이 GPU에 맞을까요?를 참조하세요.

실행하세요 — 초급부터 고급까지

Ollama를 기본 http://127.0.0.1:11434에서 수신 대기하도록 두세요. num_ctx를 높여 더 많은 컨텍스트를 사용하고, 더 큰 등급을 위해서는 gemma4:12b, gemma4:26b 또는 gemma4:31b 중 하나로 바꾸거나, 이전 세대를 위해서는 gemma3로 바꾸세요.

Capabilities

  • Reasoning: Gemma 4 supports a configurable thinking mode, off by default. Enable it by including the <|think|> control token at the start of the system prompt (or enable_thinking=True if you’re using the model card’s parse_response helper); the model then emits step-by-step reasoning before its final answer.
  • 네이티브 도구 호출의 경우, Gemma 4에서 지원됩니다. 모델 카드는 표준 system/user/assistant 역할을 사용하여 구조화된 도구 사용과 에이전트 워크플로를 위한 네이티브 함수 호출을 문서화합니다.
  • 비전 — 다중 모드로, 전체 Gemma 4 제품군에서 텍스트와 이미지(가변 종횡비 및 해상도)를 지원하며, Gemma 3 (4b 이상)도 비전 기능을 지원합니다.
  • Audio E2B 및 E4B만 지원합니다. 기본 제공 자동 음성 인식(ASR) 및 음성을 번역된 텍스트로 변환하는 기능으로, 요청당 최대 30초의 오디오를 처리할 수 있습니다.
  • 긴 컨텍스트: 131,072 토큰이 E2B/E4B에서 기본 제공되며, 262,144 토큰은 12B, 26B-A4B, 및 31B에서 지원됩니다.

Tokios와 연결하세요.

Gemma가 로컬에서 실행되면 Tokios 커넥터를 페어링하여 Claude Code, Cline 또는 기타 호환 클라이언트에서 https://api.tokios.com로 접근할 수 있게 하세요. localhost:11434에서만 접근하는 대신에.
1

Tokios 커넥터 페어링

Sign in at tokios.com/console, open the Setup tab, and click Start pairing to get a one-time claim code (TKS-XXXX-XXXX). Install and run the connector on the machine running Ollama:
Windows
macOS
Linux
그런 다음 approve을(를) Setup 또는 Connectors 탭의 기기에서 실행하세요.
2

커넥터를 Ollama의 /v1 API를 가리키도록 설정하세요.

Ollama는 /v1에서 OpenAI 호환 인터페이스를 제공합니다. 단일 모델 설정의 경우 콘솔의 설정 마법사가 이를 http://127.0.0.1:11434/v1로 자동으로 채웁니다. 여러 모델의 경우 tokios-connector.json에서 명시적으로 설정하세요 — 커넥터 구성을 참조하세요.
3

배포를 등록하세요

해당 Models 탭에서 모델을 등록하고 공개 배포 이름을 선택하세요. 예를 들어 gemma-tunnel입니다. 이 이름은 Ollama의 로컬 모델 ID가 아니라 클라이언트가 model 필드에 보내는 값입니다.
4

API 키 생성

In the Keys tab, click Create key. Copy the sk-tok-… key now — it’s shown only once.

어디서든 호출하세요

The model field is always your registered deployment name (gemma-tunnel above), never Ollama’s local model id. See Use Claude Code and Use Cline for full client setup.

주의사항

  • Gemma 4의 추론 모드는 기본적으로 꺼져 있습니다 — 다른 일부 추론 계열과 반대입니다. 단계별 추론을 원한다면 <|think|> 제어 토큰이나 클라이언트의 해당 기능으로 옵트인해야 합니다.
  • 오디오 입력(ASR 및 음성 번역)은 E2B 및 E4B 크기에서만 작동합니다 — 12B, 26B-A4B, 31B는 텍스트와 이미지만 허용합니다.
  • The 26B-A4B MoE needs all 26B parameters in memory even though only about 4B are active per token — size your hardware off the full download, not the active count.
  • Licensing differs by generation: Gemma 4 is Apache 2.0 and ungated, while Gemma 3 uses Google’s custom Gemma license and its Hugging Face checkpoints are gated (you accept the terms before downloading; the Ollama tags are redistributed under the same license). Google’s Gemma Prohibited Use Policy applies to both — check the license terms before commercial or sensitive deployments.
  • Gemma 3는 아주 작고 CPU 친화적인 배포(270m, 1b)에 여전히 유용하며, 이러한 배포에서는 Gemma 4의 가장 작은 등급(E2B)이 여전히 필요보다 무거울 수 있습니다.
New same-class alternative. Meta’s Muse Glimmer 30B lands in the same tier as gemma4:31b — dense, multimodal, Apache 2.0, and sized for one consumer GPU. Meta benchmarks them against each other directly and its numbers favour Muse Glimmer, but they are vendor-run with no independent reproduction yet. Gemma 4 still spans a much wider range, from E2B on edge hardware up to 31B; Muse Glimmer ships at one size. Test both on your own workload.

빠른 시작

커넥터를 페어링하고 첫 모델을 엔드 투 엔드로 등록하세요.

어떤 크기의 모델이 GPU에 적합한가요?

Gemma를 가져오기 전에 사용 가능한 VRAM에 맞추세요.

양자화 및 하드웨어

Gemma의 형식 — GGUF, QAT, MLX, NVFP4 — 중 어느 것이 귀하의 하드웨어에서 실행되나요?

어떤 로컬 모델을 어떤 작업에 사용할까요?

작업별로 Gemma가 다른 로컬 모델과 어떻게 비교되는지 확인하세요.