BioPlayground

๐Ÿงฌ
โ† AI Tools
etcadvanced

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)๊นŒ์ง€ ๋Œ€ํญ ๋‹จ์ถ•ํ•˜์—ฌ ๊ฐœ๋ฐœ ์ƒ์‚ฐ์„ฑ์„ ๋น„์•ฝ์ ์œผ๋กœ ํ–ฅ์ƒ์‹œํ‚ต๋‹ˆ๋‹ค.

๐Ÿ’ป ํ•„์š”ํ•œ ์ปดํ“จํ„ฐ ์‚ฌ์–‘

๐Ÿง RAM

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 ์‘๋‹ต ๊ฐ’์—์„œ ๋ถˆํ•„์š”ํ•œ ๊ณต๋ฐฑ๊ณผ ์ค‘๋ณต ํ‚ค ์ •๋ณด๋ฅผ ์ œ๊ฑฐํ•˜์—ฌ ๋ฐ์ดํ„ฐ ์‹œ๋งจํ‹ฑ์„ ์œ ์ง€ํ•œ ์ฑ„ ํ…์ŠคํŠธ ํฌ๊ธฐ๋ฅผ ๋Œ€ํญ ๊ฐ์ถ•ํ•ฉ๋‹ˆ๋‹ค.

๐Ÿ“„ ๊ณต์‹๋ฌธ์„œ๐Ÿ™ GitHub

๐Ÿ“ ์—…๋ฐ์ดํŠธ ๋…ธํŠธ

  1. vv0.27.06/25/2026

    ์ด๋ฒˆ ์—…๋ฐ์ดํŠธ์—์„œ๋Š” ์ถœ๋ ฅ ํ† ํฐ์„ ์ค„์—ฌ์ฃผ๋Š” ๊ธฐ๋Šฅ์ด ๊ฐ•ํ™”๋˜์–ด, ๋Œ€๊ทœ๋ชจ ์œ ์ „์ฒด๋‚˜ ๋‹จ๋ฐฑ์งˆ ์„œ์—ด ๋ถ„์„ ์‹œ ๋ฐœ์ƒํ•˜๋Š” AI ์šด์˜ ๋น„์šฉ์„ ํšจ๊ณผ์ ์œผ๋กœ ์ ˆ๊ฐํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋˜ํ•œ ์ดˆ๋‹น ํ† ํฐ ์ฒ˜๋ฆฌ๋Ÿ‰(tokens/sec)์„ ์ธก์ •ํ•  ์ˆ˜ ์žˆ๋Š” ๊ธฐ๋Šฅ์ด ์ถ”๊ฐ€๋˜์–ด, ๋ณต์žกํ•œ ๋ฐ”์ด์˜ค ๋ฐ์ดํ„ฐ ์ฒ˜๋ฆฌ ์†๋„๋ฅผ ์ •๋ฐ€ํ•˜๊ฒŒ ๋ชจ๋‹ˆํ„ฐ๋งํ•˜๊ธฐ ์ข‹์•„์กŒ์Šต๋‹ˆ๋‹ค. ์ƒˆ๋กญ๊ฒŒ ๋„์ž…๋œ 'headroom doctor' ์ง„๋‹จ ๋„๊ตฌ๋Š” ์„ค์ • ์˜ค๋ฅ˜๋ฅผ ๋น ๋ฅด๊ฒŒ ์ฐพ์•„์ฃผ์–ด ์—ฐ๊ตฌ์šฉ AI ์ธํ”„๋ผ๋ฅผ ๋”์šฑ ์•ˆ์ •์ ์œผ๋กœ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ๊ฒŒ ๋„์™€์ค๋‹ˆ๋‹ค.

๐Ÿงช ๊ด€๋ จ ์ƒ๋ช…์˜ ์ฝ”๋“œ

๊ด€๋ จ๋œ ์ƒ๋ช…์˜ ์ฝ”๋“œ ๊ธ€์ด ์•„์ง ์—†์Šต๋‹ˆ๋‹ค.