나만의 모델: 비용, 컨텍스트, 아이콘

해 보기

Ollama로 로컬에서 돌리는 Llama 모델이라면, 이 내용을 ~/Library/Application Support/Gnista/Models/ollama.json으로 저장하세요:

{
  "version": 1,
  "match": ["llama3.1:8b"],
  "price": "free",
  "context": 131072
}

10초 안에 llama3.1:8b를 쓰는 세션에 비용 $0과 131K 토큰 컨텍스트 중 얼마나 썼는지가 표시돼요. 아이콘은 Gnista가 이미 아는 Meta의 것이에요. 설정 ▸ 에이전트 ▸ 모델에 파일이 나오고, 거기 있는 ‘모델 폴더 보기’로 폴더를 열 수 있어요.

모델 파일

모델 하나나 모델 계열 하나에 파일 하나. 이름은 영문 소문자, 숫자, -, _로 32자까지이고, .json으로 끝나요. 필수 키는 match뿐이고, icon, price, context 중 하나는 꼭 있어야 해요.

{
  "version": 1,
  "maker": "Acme",
  "match": ["acme-coder", "acme"],
  "icon": "acme.svg",
  "motion": "breathe",
  "monochrome": false,
  "price": { "input": 0.5, "output": 1.5, "cacheRead": 0.05, "cacheWrite": 0.6 },
  "context": 200000,
  "about": "Prices from our internal rate card."
}

키	하는 일
`version`	`1`.
`match`	필수. 이 파일이 맞을 모델 ID의 일부, 32개까지. 에이전트가 알려 주는 그대로예요: `llama3.1:8b`, `acme-coder`. 대소문자는 따지지 않아요. 세 글자 이상이면 ID 어디에 있어도 맞고, 두 글자 이하면 한 단어로 있을 때만 맞아요. 그래서 `o3`는 `o3-mini`에는 맞지만 `foo3`에는 맞지 않아요.
`maker`	제공사. 설정에서 파일 이름으로 쓰여요. 40자까지.
`icon`	같은 폴더의 SVG나 PNG 파일, 1MB까지. 에이전트 아이콘 위에 작은 배지로 보여요. 없으면 Gnista가 아는 모델은 제공사의 아이콘을 그대로 써요.
`motion`	에이전트가 작업하는 동안 배지가 움직이는 방식: `spin`, `twinkle`, `bob`, `swim`, `rock`, `breathe` 중 하나, 또는 원하는 속도로: `{"name": "spin", "period": 10}`.
`monochrome`	한 가지 색의 마크면 `true`. 주변 텍스트 색으로 그려져요.
`price`	`"free"`, 또는 100만 토큰당 미국 달러: `input`과 `output`, 선택으로 `cacheRead`(없으면 input의 10분의 1)와 `cacheWrite`(없으면 input의 1.25배).
`context`	모델의 컨텍스트 윈도우(토큰 수). 얼마나 찼는지 보여 주는 링에 쓰여요.
`about`	다음에 파일을 고칠 사람을 위한 메모. Gnista는 보여 주지 않아요.

1MB가 넘거나 어디든 잘못된 곳이 있는 파일(모르는 키, 요금이 아닌 요금, Gnista가 읽을 수 없는 아이콘)은 절반만 쓰이는 일 없이 통째로 무시돼요. 설정 ▸ 에이전트 ▸ 모델에 이유와 함께 표시돼요.

모델에 맞는 파일 고르기

내 파일이 Gnista 자체 파일보다 먼저예요. 여러 파일이 맞으면 가장 길게 맞는 쪽이 이겨요. llama-3.1-nemotron은 Meta(llama)가 아니라 NVIDIA(nemotron)의 모델이에요.
아이콘은 아이콘이 있는 파일 중 가장 잘 맞는 것에서, 요금과 컨텍스트는 그 값이 있는 파일 중 가장 잘 맞는 것에서 가져와요. 요금만 있는 파일이면 제공사의 아이콘이 그대로 남아요.
엔드포인트는 직접 쓰는 쪽이 가장 잘 아니까, 내 요금과 컨텍스트가 Gnista가 아는 공개 요금보다 먼저예요. 단, 에이전트가 직접 알려 주는 컨텍스트 윈도우가 있으면 그게 우선이에요.
모델이 에이전트 제공사의 것이면 배지가 보이지 않아요. Claude를 쓰는 Claude Code처럼요.

더 많은 예시

LM Studio의 무료 모델, Gnista에 있는 Qwen 아이콘으로:

{ "version": 1, "match": ["qwen2.5-coder-32b"], "price": "free", "context": 32768 }

회사 엔드포인트, 자체 아이콘과 요금으로. acme.svg를 같은 폴더에 두세요:

{
  "version": 1,
  "maker": "Acme",
  "match": ["acme-coder"],
  "icon": "acme.svg",
  "motion": "breathe",
  "price": { "input": 0.5, "output": 1.5 },
  "context": 200000
}

어디에 보이나요

배지는 모델을 알려 주는 에이전트(Claude Code, Codex, OpenCode, Antigravity, Droid 등)와, model을 보내는 직접 만든 도구(커스텀 에이전트)에서 보여요. 비용과 컨텍스트는 Gnista가 세션을 읽는 에이전트에서 보이고, 어떤 에이전트인지는 설정 ▸ 에이전트에 표시돼요.