Headroom
๐จ **๋ณธ ์น์ ์ด BP ์ฌ์ดํธ(/ai-tools/[slug])์ ๊ทธ๋๋ก ๋ ธ์ถ๋ฉ๋๋ค.** ยงํ์ง baseline ยงdescription ๋ฃฐ์ ๋ฐ๋์ ์ค์:
๐จ ๋ณธ ์น์ ์ด BP ์ฌ์ดํธ(/ai-tools/[slug])์ ๊ทธ๋๋ก ๋ ธ์ถ๋ฉ๋๋ค. ยงํ์ง baseline ยงdescription ๋ฃฐ์ ๋ฐ๋์ ์ค์: - 3-4 ๋จ๋ฝ ์์ ํ (bullet ์ ๋ X โ `-` ์ฌ์ฉ 0๊ฑด) - `๊ตต๊ฒ` 1-2๊ฐ๋ง (๋จ๋ฐ X โ Markdown ๊ฐ๋ ์ฑ ํ๊ดด ์ฌ์ดํด ๋ฐ์ , 2026-06-16) - ๋น์ 1๊ฐ ์ด์ ("GPT๊ฐ ํ ์คํธ ์ฒ๋ฆฌํ๋ฏ, X๋ ..." ํํ) - ์ ์ฒด์ฑ โ ํ๊ณ+์ฐจ๋ณ์ โ ํ์ฉ ์๋๋ฆฌ์ค ํ๋ฆ - 1,500-3,000์ ํ๊ตญ์ด (Cellpose baseline 788์ ยฑ ๋ง์ง OK) - ์์ด ํ์ ์ฉ์ด ํ๊ธ ๋ณ๊ธฐ ("Vector flow", "U-Net ์ํคํ ์ฒ") - ๋ณธ ์น์ ์์ฒด์ `##`/`###` ํค๋ฉ X (๋จ๋ฝ ๋ถ๋ฆฌ๋ ๊ณต๋ฐฑ ํ ์ค๋ก) Headroom์ LLM(๋ํ ์ธ์ด ๋ชจ๋ธ)์ ์ปจํ ์คํธ ์๋์ฐ(Context Window) ํฌ๊ธฐ ํ๊ณ์ ํ ํฐ ์๋ชจ ๋น์ฉ์ ๊ทน์ ์ผ๋ก ํด๊ฒฐํ๊ธฐ ์ํด ๊ฐ๋ฐ๋ ๊ณ ์ฑ๋ฅ ํฌ๋ช ์ปจํ ์คํธ ์์ถ ๋ ์ด์ด(Context Compression Layer)์ ๋๋ค. ์ด ๋๊ตฌ๋ AI ์์ด์ ํธ๋ RAG(๊ฒ์ ์ฆ๊ฐ ์์ฑ) ์์คํ ์ด LLM์ผ๋ก ๋ฐ์ดํฐ๋ฅผ ์ ์กํ๊ธฐ ์ง์ ์ ์๋ํ๋ฉฐ, ๊ฐ๋ฐ์๊ฐ ์์ฑํ ์์ค ์ฝ๋๋ ํด ํธ์ถ ๊ฒฐ๊ณผ๋ฌผ, ๊ฑฐ๋ํ ํ ์คํธ ๋ก๊ทธ ๋ฐ RAG ์ฒญํฌ ๋ฑ์ ๊ตฌ์กฐ๋ฅผ ์ค์๊ฐ์ผ๋ก ๋ถ์ํ๊ณ ์์ถํฉ๋๋ค. ๋ง์น ๋์ฉ๋ ํ๋ฌผ์ ๋ฐฐ์กํ๊ธฐ ์ ์ ๊ณ ์์ถ ์ง๊ณต ํฌ์ฅ์ ์ ์ฉํ์ฌ ๋ฌผ๋ฆฌ์ ๋ถํผ๋ฅผ ์ต์ํํ๋ฏ, ์ด ๊ธฐ์ ์ ์๋ ๋ฐ์ดํฐ๊ฐ ๊ฐ์ง ๊ณ ์ ํ ์๋งจํฑ ๊ตฌ์กฐ์ ์ ๋ฐ์ฑ์ ์ ์งํ๋ฉด์๋ ์ ์ก ํ ํฐ ํฌ๊ธฐ๋ฅผ 60%์์ ์ต๋ 95%๊น์ง ํ๊ธฐ์ ์ผ๋ก ์ค์ฌ์ค๋๋ค. ๋ด๋ถ์ ์ผ๋ก๋ API ์์ฒญ์ ๊ฐ๋ก์ฑ๋ ๋ก์ปฌ ํ๋ก์(Local Proxy) ์๋ฒ ๋ฐ MCP(Model Context Protocol) ์๋ฒ ํํ๋ก ๋์ํ์ฌ, ๊ฐ๋ฐ์๋ก ํ์ฌ๊ธ ๊ธฐ์กด ์ฝ๋์ ๋ณ๊ฒฝ ์์ด ์ฆ๊ฐ์ ์ธ ํ ํฐ ์ ๊ฐ ํจ๊ณผ๋ฅผ ์ฒด๊ฐํ ์ ์๋๋ก ์ง์ํฉ๋๋ค. ๊ธฐ์กด์ ํ๋กฌํํธ ์์ง๋์ด๋ง์ด๋ ๋จ์ํ ํ ์คํธ ์ฌ๋ผ์ด์ฑ ๋ฐฉ์์ LLM์ ์ ๋ ฅ๋๋ ์ ์ฒด ๋ฌธ๋งฅ์ ํ๋ฆ์ ํผ์ํ๊ฑฐ๋, ์ ๋ฐํ ์ง์ ์ฌํญ ๋ฐ ์์ค ์ฝ๋์ ๋ฌธ๋ฒ ๊ตฌ์กฐ๋ฅผ ๊นจ๋จ๋ ค ์ต์ข ๋ต๋ณ์ ํ์ง์ ์ฌ๊ฐํ๊ฒ ์ ํ์ํค๋ ํ๊ณ๊ฐ ์์์ต๋๋ค. ํนํ ๊ฑฐ๋ํ JSON ๋ฐ์ดํฐ๋ ๋ณต์กํ ์์คํ ๋ก๊ทธ, ์ฌ๋ฌ ํ์ผ์ ๊ฑธ์น ์์ค ์ฝ๋๋ค์ ๋ค๋ฃฐ ๋ ๋จ์ ํ ์คํธ ์ถ์ฝ์ ์ค์ํ ์ธ๋ถ ๋งค๊ฐ๋ณ์๋ ๋ ํฌ์ธํฐ ์์ธ ๋ฑ์ ํต์ฌ ๋จ์๋ฅผ ์ ์ค์ํค๋ ์น๋ช ์ ์ธ ๊ฒฐ๊ณผ๋ฅผ ๋ณ๊ณค ํ์ต๋๋ค. ๋ฐ๋ฉด Headroom์ ๋ฐ์ดํฐ ์ ํ๋ณ ๋ง์ถคํ ์์ถ ํ์ดํ๋ผ์ธ์ธ CCR(Compress-Cache-Retrieve) ๊ตฌ์กฐ๋ฅผ ๋์ ํ์ฌ ์ด๋ฌํ ๋ฌธ์ ๋ฅผ ์๋ฒฝํ ํด๊ฒฐํฉ๋๋ค. ์ฝ๋์ ๋ฌธ๋ฒ ๊ตฌ์กฐ๋ฅผ ๋ถ์ํ๋ ์ถ์ ๊ตฌ๋ฌธ ํธ๋ฆฌ(AST-based code compression) ๊ธฐ์ ๊ณผ ์ ํ ๋ฐ์ดํฐ ์ ์ฉ ์์ถ ์๊ณ ๋ฆฌ์ฆ(SmartCrusher), ๊ทธ๋ฆฌ๊ณ ์ผ๋ฐ ํ ์คํธ ์ ์ฉ ์์ถ๊ธฐ(Kompress)๋ฅผ ์ ๊ธฐ์ ์ผ๋ก ์กฐํฉํ์ฌ ์๋ฏธ๋ก ์ ์์ค์ ์ ๋ก์ ๊ฐ๊น๊ฒ ์ ์งํฉ๋๋ค. ๋ํ ์์ถ๋ ์ํ๋ก ๋ชจ๋ธ์ ์ ๋ฌ๋ ํ ์คํธ์ ์๋ณธ ๋ฐ์ดํฐ ์ฌ์ด์ ๋์ ๋งคํ ํ ์ด๋ธ์ ๊ด๋ฆฌํ๋ฏ๋ก, LLM์ด ํ์๋ก ํ ๋ ์บ์ฑ๋ ์๋ณธ์ ์ค์๊ฐ์ผ๋ก ๋ค์ ๋ณต์ํ์ฌ ์ ํํ ๋ต๋ณ์ ๋์ถํ ์ ์์ต๋๋ค. ๋๊ท๋ชจ ์ฝ๋๋ฒ ์ด์ค ๋ถ์์ด๋ ๋ฉํฐ ์์ด์ ํธ ํ์ ํ์ดํ๋ผ์ธ์ ์ด์ํ๋ ๊ฐ๋ฐ์๋ Headroom์ ํ์ฉํ์ฌ ์ธํ๋ผ ๋น์ฉ๊ณผ ์๋ต ์ง์ฐ์ ๋์์ ๊ทน์ ์ผ๋ก ๋จ์ถํ ์ ์์ต๋๋ค. ์๋ฅผ ๋ค์ด, ์๋ฐฑ ๊ฐ์ ์์ค ์ฝ๋ ํ์ผ๊ณผ ๋ฐฉ๋ํ ์คํ ๋ก๊ทธ๋ฅผ ์ฐธ์กฐํด์ผ ํ๋ Aider๋ Cursor ๊ฐ์ ์ฝ๋ ์์ฑ CLI ์์ด์ ํธ๋ฅผ ๊ฐ๋ํ ๋, ๊ฐ๋ฐ์๋ ๋ก์ปฌ ํ๊ฒฝ์ Headroom ํ๋ก์๋ฅผ ๋์ฐ๊ณ API ์๋ํฌ์ธํธ๋ง ๋ณ๊ฒฝํ์ฌ ์ธ์ ์ ์์ํฉ๋๋ค. ์ด ํ๋ก์๋ ์์ด์ ํธ๊ฐ ๋๊ตฌ๋ฅผ ํธ์ถํ์ฌ ์์ฑํด๋ด๋ ๊ธฐ๊ฐ๋ฐ์ดํธ ๋จ์์ ์์ ํ ์คํธ๋ ์๋ฌ ์ถ์ (Stack Trace) ๋ก๊ทธ๋ฅผ AST ๊ธฐ๋ฐ ์ฝ๋๋ก ์์ถํ์ฌ LLM์ ์ ๋ฌํ๋ฉฐ, ๊ฒฐ๊ณผ์ ์ผ๋ก API ํธ์ถ ํ ๋ฒ์ ์๋ชจ๋๋ ์์ญ๋ง ํ ํฐ์ ์์ ๋ง ๊ฐ ์ดํ๋ก ์ค์ฌ์ค๋๋ค. ์ฐ๊ตฌ์์ด๋ ๊ฐ๋ฐ์๋ ์ด๋ฅผ ํตํด ํ๋ฃจ ์๋ฐฑ ๋ฌ๋ฌ์ ๋ฌํ๋ ์์ฉ LLM API ๋น์ฉ์ ๋จ ๋ช ๋ฌ๋ฌ ์์ค์ผ๋ก ๋ฐฉ์ดํ ์ ์์ ๋ฟ๋ง ์๋๋ผ, ํ๋กฌํํธ ์ ๋ ฅ ํฌ๊ธฐ ๊ฐ์์ ๋ฐ๋ฅธ LLM ์ถ๋ก ์ง์ฐ ์๊ฐ(Latency)๊น์ง ๋ํญ ๋จ์ถํ์ฌ ๊ฐ๋ฐ ์์ฐ์ฑ์ ๋น์ฝ์ ์ผ๋ก ํฅ์์ํต๋๋ค.
๐ป ํ์ํ ์ปดํจํฐ ์ฌ์
0 (CPU ๋จ๋ ์คํ ๊ฐ๋ฅ) / ML ๊ฐ์ ๊ธฐ๋ฅ ํ์ฑํ ์ NVIDIA GPU 4GB+ ๊ถ์ฅ
์ฝ 500MB (๊ธฐ๋ณธ ํจํค์ง ๋ฐ ๊ด๋ จ ์์กด์ฑ ๋ชจ๋ ์ค์น ๊ณต๊ฐ)
โก ์ค์น๋ฒ
### 4-1. Quick Start
```bash
pip install "headroom-ai[all]"
```
### 4-2. ์์ธ ์ค์น
```bash
# Node.js/TypeScript ํ๊ฒฝ์์ ์ค์น ์
npm install headroom-ai
# Docker ์ปจํ
์ด๋ ์คํ์ ํตํ ํ๋ก์ ์๋น์ค ์คํ ์
docker pull ghcr.io/chopratejas/headroom:latest
docker run -d -p 8787:8787 ghcr.io/chopratejas/headroom:latest
```๐งฌ ๋ฐ์ด์ค ํ์ฉ
AI ์ฝ๋ฉ ์์ด์ ํธ ํ ํฐ ์ ๊ฐ**
Cursor, Aider, Claude Code ๋ฑ์ ๋๊ตฌ์ ํจ๊ป ์ฌ์ฉํ์ฌ ์์ค ์ฝ๋ ํ์ผ์ด๋ ๊ธด ํด ์ถ๋ ฅ๋ฌผ์ด LLM์ ์ ์ก๋๊ธฐ ์ ์ ์์ถํ๊ณ , ๋น์ฉ์ ์ต๋ 90% ์ด์ ์ ์ฝํฉ๋๋ค.
๋๊ท๋ชจ RAG ํ์ดํ๋ผ์ธ ์ต์ ํ**
์ง์ ๊ธฐ๋ฐ ๊ฒ์(RAG)์์ ์ถ์ถ๋ ๋ฌธ์ ์ฒญํฌ(Chunk)๋ค์ ์์ถํ์ฌ ์ปจํ ์คํธ ์ฐฝ ๊ณต๊ฐ์ ์ถ๊ฐ๋ก ํ๋ณดํ๊ณ , ๋ ๋ง์ ์ฐธ์กฐ ์ ๋ณด๋ฅผ LLM์ ํ ๋ฒ์ ๊ณต๊ธํฉ๋๋ค.
๋์ฉ๋ ์ ํ ๋ฐ์ดํฐ ๋ฐ JSON ์ฒ๋ฆฌ**
์น ํฌ๋กค๋ง ๋ฐ์ดํฐ๋ ๊ตฌ์กฐํ๋ API JSON ์๋ต ๊ฐ์์ ๋ถํ์ํ ๊ณต๋ฐฑ๊ณผ ์ค๋ณต ํค ์ ๋ณด๋ฅผ ์ ๊ฑฐํ์ฌ ๋ฐ์ดํฐ ์๋งจํฑ์ ์ ์งํ ์ฑ ํ ์คํธ ํฌ๊ธฐ๋ฅผ ๋ํญ ๊ฐ์ถํฉ๋๋ค.
๐ ์ ๋ฐ์ดํธ ๋ ธํธ
- vv0.27.06/25/2026
์ด๋ฒ ์ ๋ฐ์ดํธ์์๋ ์ถ๋ ฅ ํ ํฐ์ ์ค์ฌ์ฃผ๋ ๊ธฐ๋ฅ์ด ๊ฐํ๋์ด, ๋๊ท๋ชจ ์ ์ ์ฒด๋ ๋จ๋ฐฑ์ง ์์ด ๋ถ์ ์ ๋ฐ์ํ๋ AI ์ด์ ๋น์ฉ์ ํจ๊ณผ์ ์ผ๋ก ์ ๊ฐํ ์ ์์ต๋๋ค. ๋ํ ์ด๋น ํ ํฐ ์ฒ๋ฆฌ๋(tokens/sec)์ ์ธก์ ํ ์ ์๋ ๊ธฐ๋ฅ์ด ์ถ๊ฐ๋์ด, ๋ณต์กํ ๋ฐ์ด์ค ๋ฐ์ดํฐ ์ฒ๋ฆฌ ์๋๋ฅผ ์ ๋ฐํ๊ฒ ๋ชจ๋ํฐ๋งํ๊ธฐ ์ข์์ก์ต๋๋ค. ์๋กญ๊ฒ ๋์ ๋ 'headroom doctor' ์ง๋จ ๋๊ตฌ๋ ์ค์ ์ค๋ฅ๋ฅผ ๋น ๋ฅด๊ฒ ์ฐพ์์ฃผ์ด ์ฐ๊ตฌ์ฉ AI ์ธํ๋ผ๋ฅผ ๋์ฑ ์์ ์ ์ผ๋ก ๊ด๋ฆฌํ ์ ์๊ฒ ๋์์ค๋๋ค.
๐งช ๊ด๋ จ ์๋ช ์ ์ฝ๋
๊ด๋ จ๋ ์๋ช ์ ์ฝ๋ ๊ธ์ด ์์ง ์์ต๋๋ค.