๋ด ํ๋ฉด ๊ธฐ๋ก์ ๋ฌผ์ด๋ณด๋ฉด ๊ทผ๊ฑฐ์ ํจ๊ป ๋ตํ๋ ๊ฐ์ธ์ฉ RAG.
| ๊ฒ์ recall@8 ๊ณจ๋ ์ 25๋ฌธํญ ์ง์ ๋ผ๋ฒจ๋ง |
์ฒซ ์๋ต ยท 5.3์ด์์as_completed โ ์บ์ ์ ์ค๊ณผ ๋ฌด๊ด |
ํ๋ฃจ ์์ฝ ํ๋กฌํํธ 100๋ง ์ โ 2.3๋ง ์ |
screenpipe๊ฐ ๋ช ์ด๋ง๋ค ์ฐ์ด๋ ํ๋ฉด ๊ธฐ๋ก์ ์ฝ์ด์, ํ๊ตญ์ด ์ง๋ฌธ์ ๊ทผ๊ฑฐ์ ํจ๊ป ๋ตํ๋ค. ์์งยท์ ์ ยท์๋ฒ ๋ฉยท๊ฒ์ยท๋ผ์ฐํ ยท์์ฝยท์์ด์ ํธยท์๋นยท๋ฐฐํฌ๊ฐ ์ ๋ถ ์ด ์ ์ฅ์ ์์ ์๊ณ , ์๋ณธ ๋ฐ์ดํฐ๋ ์ด ์ปดํจํฐ๋ฅผ ๋ ๋์ง ์๋๋ค.
ํต์ฌ ์ฑ๊ณผ โ ๋ฌธ์ โ ํด๊ฒฐ โ ๊ฒฐ๊ณผ
- ๋๊ธฐ ์๊ฐ: ์ฌ๋ฌ ๋ ์ง๋ฅผ
asyncio.gather๋ก ๋ฌถ์ผ๋ ๊ฐ์ฅ ๋๋ฆฐ ํ๋ฃจ๊ฐ ์ ์ฒด ์๋ต์ ๊ฒฐ์ ํด ๊ทธ๋๊น์ง ํ๋ฉด์ด ๋น์ด ์์๋ค โasyncio.as_completed๋ก ๋จผ์ ๋๋ ๋ ์ง๋ถํฐ ์คํธ๋ฆฌ๋ฐ โ ์ฒซ ์๋ต 5.3์ด โ 1.4์ด(โ74%). ์บ์ ์ ์ค๊ณผ ๋ฌด๊ดํ๊ฒ ํญ์ ์ฌํ๋๋ค. - ๊ฒ์ ํ์ง: "๊ฒ์์ด ์ ๋ต์ ๊ฐ์ ธ์ค๋์ง" ์ด ๋ฐฉ๋ฒ์ด ์์๋ค โ ๊ณจ๋ ์
25๋ฌธํญ์ ์ง์
๋ผ๋ฒจ๋งํ๊ณ recall@k๋ฅผ ์ค์ธก โ
RETRIEVE_K10โ8, recall 1%p๋ฅผ ๋ด์ฃผ๊ณ ํ๋กฌํํธ ๊ทผ๊ฑฐ 20% ์ ๊ฐ. - ๋น์ฉ/์์ ์ฑ: ์ด๋ฒคํธ๊ฐ ๋ง์ ๋ ํ๋ฃจ ์์ฝ ํ๋กฌํํธ๊ฐ 1,005,356์๋ก ํฐ์ก๋ค โ
์์๋ฅด๊ธฐ ๋์ ๊ท ๋ฑ ์์๋ด๊ธฐ(
_thin_out()) + ๊ฐ์ ์ํ โ 22,730์(โ97.7%), ํ๋ฃจ ์ ์ฒด ์ปค๋ฒ๋ ์ ์ง. - ์ ํ๋: ์ฌ์ฉ ํ์๋ฅผ LLM์ ๋งก๊ฒผ๋๋ ์ค์ 340ํ๋ฅผ "5ํ"๋ก ๋ตํ๋ค โ ์ง๊ณ๋ LLM์ ๋นผ๊ณ metadata๋ฅผ ์ฝ๋๊ฐ ์ง์ ์ โ ์ค์ธก ์นด์ดํธ์ ์ ํํ ์ผ์น, ์์ด์ ํธ๊ฐ ๋๊ตฌ๋ฅผ ์ด๋ค ์์๋ก ๋ถ๋ฌ๋ ์ ๊นจ์ง.
| ๊ธฐ๊ฐ / ์ญํ | ๊ฐ์ธ ํ๋ก์ ํธ ยท 1์ธ ๊ฐ๋ฐ ยท ์ปค๋ฐ 68๊ฐ (2026-07-28 ~ 08-06) |
| ์์ธ ๋ฐ์ดํฐ | ์ด๋ฒคํธ 30,521๊ฐ / 15์ผ์น(2026-07-22 ~ 08-05) / ์บก์ฒ ํ๋ ์ 55,188๊ฐ / ์ฑ 27์ข / ๋ฒกํฐ DB 688MB |
| ๊ฒฐ๊ณผ๋ฌผ | ์น ์๋น์ค(๋๋ฉยท์ง์ยทํ์) + ๋ก์ปฌ ์์งยท๋๊ธฐํ Mac ์ฑ(.dmg) + GitHub Actions โ GHCR โ EC2 ์๋ ๋ฐฐํฌ |
์คํ ์๋ฌธยท์คํจํ ์๋ยท๊ธฐ๊ฐํ ๊ฒฐ๋ก ๊น์ง
docs/์eval/์ ๋จ์ ์๋ค. โ ๋ฌธ์ ์ง๋ ยท ์ค์น์ ์คํ์ ๋งจ ์๋ ๋น ๋ฅธ ์์.
โถ 2๋ถ ์์ฝ๋ณธ ยท โถ ์ ์ฒด๋ณธ
๋๋ฉ โ ์ค์น ์๋ด โ ํ์ โ ๋ฌผ์ด๋ณด๊ธฐ โ ๋ต๋ณ๊น์ง ์ค์ ๋์. ํธ์งยท๊ฐ์ ์์.
| ์๊ฐ | 1. ์ ๋ง๋ค์๋ ยท 2. ๋ฌด์์ ํ๋๊ฐ |
| ์ค๊ณ | 3. ์์คํ ๊ตฌ์กฐ ยท 4. ํ์ดํ๋ผ์ธ |
| ๊ฒ์ฆ | 5. ํ๊ฐ ยท 6. ํต์ฌ ์ค๊ณ ๊ฒฐ์ ยท 7. ํธ๋ฌ๋ธ์ํ ยท 8. ์ฑ๋ฅ |
| ์ด์ | 9. ์น ์๋น์ค์ API ยท 10. ๋ฐฐํฌ ยท 11. ๊ฐ์ธ์ ๋ณด |
| ๊ทธ ์ธ | 12. ์๋ ค์ง ํ๊ณ ยท 13. ๋ฌธ์ ์ง๋ ยท 14. ๋น ๋ฅธ ์์ |
๊ธ์์ผ๋ง๋ค ์ฃผ๊ฐ ๊ณต์ ๋ฅผ ์ธ ๋๊ฐ ์ ์ผ ๋ง๋งํ๋ค. ๋ถ๋ช ๋ฐ๋นด๋๋ฐ ๋ญ ํ๋์ง๊ฐ ๊ธฐ์ต์ด ์ ๋์, ์ปค๋ฐ ๋ก๊ทธ์ ๋ธ๋ผ์ฐ์ ํ์คํ ๋ฆฌ๋ฅผ ํ์ฐธ ์ญ์ถ์ ํ๊ณ ๋์์ผ ๊ฒจ์ฐ ๋ช ์ค์ ์ ์๋ค. ํ๋ฃจ ์ข ์ผ ํ๋ฉด์ ๋ณด๋ฉฐ ์ผํ๋๋ฐ, ์ ์ ๊ทธ ๊ธฐ๋ก์ ์ด๋์๋ ๋จ์ ์์ง ์์๋ค.
ํ๋ฉด ๊ธฐ๋ก ์์ฒด๋ ์์ ์ ์๋ ๋ฐฉ๋ฒ์ด ์์๋ค.(screenpipe). ์ด ํ๋ก์ ํธ๋ ๊บผ๋ด๋ ์ชฝ์ ์ง์คํ๋ค.
1. ๊ธฐ๋ก์ ์๋๋ฐ ์ง๋ฌธ์ผ๋ก ๋ชป ๊บผ๋ธ๋ค. screenpipe๊ฐ ์ ๊ณตํ๋ ๊ฒ์์ FTS5 ํค์๋ ๋งค์นญ์ด๋ค. ํ๋ฉด์ ์์ด๋ก "Commit ํ์ "์ด๋ผ๊ณ ์ฐํ ์์ผ๋ฉด "์ปค๋ฐ ์ปจ๋ฒค์ "์ด๋ผ๋ ์ง๋ฌธ์ผ๋ก๋ ์ ์กํ๋ค โ
"์ด์ ๋ญ ํ์ง", "์ด๋ฒ ์ฃผ ์ธ์ ๊ฐ ์ ์ผ ๋ฐ๋นด์ด", "์นดํก ๋ช ๋ฒ ์ผฐ์ด" ๊ฐ์ ์ง๋ฌธ์ ์ ์ด์ ํค์๋๋ก ํํํ ์ ์๋ ํํ๊ฐ ์๋๋ค. ๋ ์ง๋ฅผ ํด์ํ๊ณ , ํ๋ฃจ๋ฅผ ์์ฝํ๊ณ , ๋ ์ง๋ฅผ ๊ฐ๋ก์ง๋ฌ ๋น๊ตํ๊ณ , ์ธ์ด์ผ ๋ต์ด ๋์จ๋ค๊ณ ํ๋จํ๋ค.
2. ๊ทธ๋ ๋ค๊ณ ํ๋ฉด์ ํต์งธ๋ก ๋จ์๊ฒ ๋งก๊ธธ ์๋ ์๋ค. ํ๋ฉด ๊ธฐ๋ก์๋ ๋ฉ์ ์ ๋ํ์ ๋ก๊ทธ์ธ ํ๋ฉด์ด ๊ทธ๋๋ก ๋ค์ด์๋ค. ์ ๋ก๋ํ ์์ฉ ์๋น์ค๋ "๋ฌด์์ด ์ฌ๋ผ๊ฐ๋์ง"๋ฅผ ๋ด๊ฐ ํต์ ํ ์ ์์ด์ ์ด ๋ฐ์ดํฐ์๋ ์ธ ์ ์๋ ์ ํ์ง์๋ค. ๊ฐ์ธ์ ๋ณด๊ฐ ๊ธฐ๋ฅ์ด ์๋๋ผ ์ ์ฝ์ผ๋ก ๋จผ์ ์์๊ณ , ์ํคํ ์ฒ๊ฐ ๊ฑฐ๊ธฐ์ ๋ง์ถฐ์ก๋ค.
3. ์ํ๋ ๊ฑด ๊ฒ์ ๊ฒฐ๊ณผ๊ฐ ์๋๋ผ ๋งฅ๋ฝ์ ๋ณต์์ด์๋ค. ์ฃผ๊ฐ ๊ณต์ ์ ๋ถ์ผ ์ ์๋ ๊ฑด ๋งํฌ ๋ชฉ๋ก์ด ์๋๋ผ ๋ฌธ์ฅ์ด๋ค. "๊ทธ๋ ๋ญ ํ๋ค ๋ง์์ง"๋ฅผ ๋ค์ ์ด์ด์ ํ๋ ค๋ฉด ๋๋์ฑ ๊ทธ๋ ๋ค. ๊ทธ๋์ ๊ฒ์ ์์ ์ธ์์ธ๊ณ ๋ฌธ์์ ์ฌ๋ ๊ณต์ ์ด์์ ์ถ๋ ฅ ์์์ผ๋ก ์ฌ๋ ธ๋ค.
| ์ ์ฝ | ์ด๋ป๊ฒ ์ง์ผฐ๋ |
|---|---|
| ์๋ณธ์ ์ด ์ปดํจํฐ๋ฅผ ๋ ๋์ง ์๋๋ค | ์์ง ๋จ๊ณ์์ PII ๋ฆฌ๋์
์ ์ผ๊ณ ๋ฆฌ๋์
๋ณธ์ mode=ro๋ก๋ง ์ฝ๋๋ค. ํ๋ฉด ์บก์ฒยท์ค๋์ค ์๋ณธ๊ณผ ํ๋ ์ DB๋ ๋ก์ปฌ์๋ง ๋จ๊ณ , ์๋ฒ ๋ฉ์ ๋ก์ปฌ์์ ๋๋ธ ๋ค ์๋ฒ๋ก๋ ๋ฆฌ๋์
๋ ํ
์คํธ์ ๊ทธ ๋ฒกํฐ๋ง ์ฌ๋ฆฐ๋ค |
| ๋ต์๋ ํญ์ ๊ทผ๊ฑฐ๊ฐ ๋ถ๋๋ค | search()์ ask()๋ฅผ ์ผ๋ถ๋ฌ ๋ถ๋ฆฌํ๋ค โ ํฉ์ณ๋๋ฉด ์๋ฑํ ๊ฑธ ๊ฐ์ ธ์๋ ๊ทธ๋ด๋ฏํ ๋ต์ด ๋์์ ๋์น์ฑ์ง ๋ชปํ๋ค. UIยทCLIยทAPI ๋ชจ๋ ๋ต๊ณผ ๊ทผ๊ฑฐ๋ฅผ ๊ฐ์ด ๋ธ๋ค |
| ์ธ์ ๋ ๊ฐ์๋ผ์ธ ์ ์์ด์ผ ํ๋ค | LLM์ USE_LOCAL_LLM โ OPENAI_API_KEY โ ANTHROPIC_API_KEY 3์ค ์ค์์น. ํ๊ฒฝ๋ณ์ ํ ์ค๋ก ์์ ๋ก์ปฌ(Ollama)๊น์ง ๋ด๋ ค๊ฐ๋ค โ ๊ทธ ๊ฒฝ๋ก๋ฅผ 8๋ฌธํญ ร ๋ฐ๋๊ฐ ๋ค๋ฅธ 5์ผ๋ก API์ ์ ๋ฉด ๋น๊ตํ๋ค |
์ ์งํ๊ฒ ์ ์๋ฉด, ๊ธฐ๋ณธ ๊ตฌ์ฑ์์ ์ธ๋ถ๋ก ๋๊ฐ๋ ๊ฒ์ LLM ํธ์ถ๋ฟ์ด๊ณ ๊ทธ๋ ๊ทผ๊ฑฐ ํ ์คํธ๊ฐ ํ๋กฌํํธ์ ์ค๋ฆฐ๋ค. ๊ทธ๊ฒ๋ง์ ์์น ์์ผ๋ฉด
USE_LOCAL_LLM=1๋ก ์์ ๋ก์ปฌ ๋์์ด ๊ฐ๋ฅํ๊ณ , ๊ทธ๊ฒ ๋ก์ปฌ LLM ์คํ์ ์งํํ ์ด์ ์ด๋ค.
ํ์ ๋งํฌ๋ก ๋ฌผ์ด๋ณด๋ฉด ํํฐ๋ฅผ ์ค์ค๋ก ๋ฝ์ ๊ทธ ๋ฒ์ ์์์๋ง ๋ตํ๋ค.
์ง๋ฌธ์ ๋์ง๋ฉด ๋ผ์ฐํ
๊ฒฐ๊ณผ(Google Chrome์์ ยท ์ต๊ทผ 7์ผ)๊ฐ ๋จผ์ ๋จ๊ณ ๋ต์ด ํ ํฐ ๋จ์๋ก ํ๋ฌ๋์จ๋ค.
์ง๋ฌธ์ ํ ์ข ๋ฅ๊ฐ ์๋๋ค.
๊ฐ์ ํ์ดํ๋ผ์ธ์ผ๋ก ์ฒ๋ฆฌํ๋ฉด ์ ๋ถ ํ๋ฆฐ๋ค๋ ๊ฑธ ํ์ธํ๊ณ , ๋ต์ ๋ง๋๋ ๋ฐฉ์์ ๋ค์ฏ ๊ฐ๋๋ก ๋๋ด๋ค.
| ์ ํ | ์์ | ๋ต์ ๋ง๋๋ ๋ฐฉ์ | ๊ตฌํ |
|---|---|---|---|
| ๊ฒ์ | "์ฝ๋ํธ๋ฆฌ์์ ๋ญ ํ์์ด?" | ๋ฒกํฐ ๊ฒ์ top-k โ LLM์ด ๊ทผ๊ฑฐ๋ก ๋ต๋ณ | ask.py |
| ์ ๋ฆฌ | "์ด์ ํ๋ฃจ ์ ๋ฆฌํด์ค" | ๋ ์ง๋ณ ์์ฝ์ ๋ณ๋ ฌ ์์ฑํด ๋จผ์ ๋๋ ๊ฒ๋ถํฐ ์คํธ๋ฆฌ๋ฐ | summarize.py |
| ๋น๊ต | "์ด๋ฒ ์ฃผ ์ธ์ ๊ฐ ์ ์ผ ๋ฐ๋นด์ด?" | ๋ ์ง๋ณ ์์ฝ โ ๊ทธ ์์ฝ๋ค์ ๋ค์ LLM์ผ๋ก ๋น๊ต | summarize.py |
| ์ง๊ณ | "์นดํก ๋ช ๋ฒ ์ผฐ์ด?" | LLM์ ์ ๊ฑฐ์น๋ค. metadata๋ฅผ ์ฝ๋๊ฐ ์ง์ ์ผ๋ค | count_range() |
| ๋ณตํฉ | "์ ํ๋ธ ๋ช ๋ฒ ๋ดค๋์ง๋ ๋ญ ๋ดค๋์ง ๊ฐ์ด" | ReAct ์์ด์ ํธ๊ฐ ์ ๋๊ตฌ๋ค์ ๊ณจ๋ผ ์กฐํฉ | agent.py |
์ฌ๊ธฐ์ ์ธ์์ธ๊ณ ๋ฌธ์ยท์ฌ๋ ๊ณต์ ์ด์ ๋ ๊ฐ์ง ์ถ๋ ฅ ์์์ด ์์ด์ ํธ ๋๊ตฌ๋ก ์นํ ์๋ค. ์ฌ๋์ ์ด์๊น์ง๋ง ๋ง๋ค๊ณ , ์ค์ ์ ์ก์ ์ฌ์ฉ์๊ฐ ๋ฒํผ์ ๋๋ฌ์ผ๋ง ๋๋ ๋ณ๋ ์๋ํฌ์ธํธ๋ค.
์ ์ ํ๋ฉด์ผ๋ก ๋ ๋ณด๊ธฐ โ ์ ํ๋ณ ์ค์ ์๋ต 3๊ฑด
์ง๊ณ โ "์ด๋ฒ ์ฃผ์ ์ด๋ค ์ฑ์ ์ ์ผ ๋ง์ด ์ผ์ด?"
LLM์ ํ ๋ฒ๋ ์ ๋ถ๋ฅธ ๋ต์ด๋ค. count_range()๊ฐ chroma metadata๋ฅผ ์ง์ ์ธ์ ๋ฌธ์์ด๋ง
์กฐํฉํ๋ค. ์์ฝ๋ฌธ์ ์ฝ๊ณ LLM์ด ์ธ๊ฒ ํ๋ฉด ์ค์ 340ํ๋ฅผ "5ํ"๋ก ๋ตํ๋ ์ฌ๊ณ ๊ฐ ๋๋ค(์ค์ธก).
๋น๊ต โ "8์ 3์ผ์ด๋ 8์ 4์ผ ์ค ์ธ์ ๊ฐ ๋ ๋ฐ๋นด์ด?"
๋ ์ง๋ณ ์์ฝ์ ๊ฐ๊ฐ ๋ง๋ ๋ค ๊ทธ ์์ฝ๋ค์ ๋ค์ LLM์ ๋ฃ์ด ํ๋จ์ํจ๋ค. ์์ฝ์ ๋์ด๋ง ํด์๋ "์ด๋ ๋ ์ด ๋ ๋ฐ๋นด๋"๋ผ๋ ๋ ์ง๋ฅผ ๊ฐ๋ก์ง๋ฅด๋ ์ง๋ฌธ์ ๋ต์ด ์ ๋์จ๋ค. ๊ทผ๊ฑฐ๋ก ๋ ์๊ฐ๋์ ํ๋์ ์ง์ผ๋ฉด์ ๊ฒฐ๋ก ์ ๋ธ๋ค.
๋ณตํฉ โ "์ด๋ฒ์ฃผ์ ๊นํ๋ธ ๋ช ๋ฒ ๋ดค๋์ง๋ ์ด๋ค ์์ ํ๋์ง ๊ฐ์ด ์๋ ค์ค"
์ง๊ณ์ ๊ฒ์์ด ๋์์ ํ์ํด์ ๋ค ๊ฐ๋ ์ค ํ๋๋ก๋ ๋ชป ํธ๋ ์ง๋ฌธ์ด๋ค. route()๊ฐ
compound=true๋ก ํ์ํ๋ฉด ReAct ์์ด์ ํธ๊ฐ count_events(429ํ)์ search_events๋ฅผ
์ฐจ๋ก๋ก ๋ถ๋ฅธ ๋ค ํ๋์ ๋ต์ผ๋ก ํฉ์น๋ค.
ํ ์ค ์์ฝ โ ํ๋ฉด์ ์ฐ๊ณ ยท ๊ฑธ๋ฌ๋ด๊ณ ยท ์ดํดํ ์ ์๋ ํํ๋ก ์๋ ์ผ๊น์ง ์ ๋ถ ์๋์ผ๋ก ๋์๊ฐ๊ณ , ์ฌ์ฉ์๋ "์ด์ ๋ญ ํ์ง?"๋ผ๊ณ ํ์ ๋งํฌ๋ก ๋ฌป๊ธฐ๋ง ํ๋ฉด 1.4์ด ์์ ์ฒซ ๋ฌธ์ฅ์ ๊ทผ๊ฑฐ์ ํจ๊ป ๋ฐ๋๋ค. ์๋ณธ ๊ธฐ๋ก์ ๊ทธ๋์ ๋ด ์ปดํจํฐ ๋ฐ์ผ๋ก ๋๊ฐ์ง ์๋๋ค.
์ฌ์ฉ์๊ฐ ์ค์ ๋ก ํ๋ ์ผ์ ์ธ ๊ฐ์ง๋ฟ์ด๋ค โ โ ๋ฉ๋ด๋ฐ ์ฑ์์ ๋ นํ๋ฅผ ์ผ๋๋ค โ โก ํ๋ฃจ ๋์ "๋๊ธฐํ"๋ฅผ ๋๋ฅธ๋ค(์์ธยท์์ฝยท์ ์ก์ด ์์์ ๋๋ค) โ โข ์น์์ ๋ฌป๋๋ค. ์๋ ๋ค์ด์ด๊ทธ๋จ์ ๋๋จธ์ง ์ ๋ถ๊ฐ ์ด ์ธ ๋์ ๋ค์์ ์๋์ผ๋ก ์ฒ๋ฆฌ๋๋ ๋ถ๋ถ์ด๋ค.
๋ฐ์ดํฐ ํ๋ฆ ์์ธ โ ์์ง ยท ์์ธ ยท ์ง์ ยท ์๋น
flowchart LR
subgraph COLLECT["์์ง (๋ก์ปฌ)"]
SP["screenpipe<br/>ํ๋ฉด ์บก์ฒ + OCR/AX + PII ๋ฆฌ๋์
"] --> DB[("~/.screenpipe-redacted<br/>db.sqlite ยท ์ฝ๊ธฐ ์ ์ฉ")]
end
subgraph INDEX["์์ธ ํ์ดํ๋ผ์ธ"]
DB --> SRC["source.py<br/>ํ๋ ์ ๋ก๋ ยท UTCโKST"]
SRC --> CLN["clean.py<br/>ํ๋ ์ โ ์ด๋ฒคํธ"]
CLN --> IDX["index.py<br/>BGE-M3 ์๋ฒ ๋ฉ"]
IDX --> CH[("chroma<br/>events ์ปฌ๋ ์
")]
end
subgraph QUERY["์ง์"]
Q(["์ง๋ฌธ"]) --> RT["router.py<br/>route() โ ๊ตฌ์กฐํ ์ถ๋ ฅ 1ํ"]
RT --> ASK["ask.py / summarize.py<br/>๊ฒ์ ยท ์ ๋ฆฌ ยท ๋น๊ต ยท ์ง๊ณ"]
RT --> AG["agent.py<br/>๋ณตํฉ์ด๋ฉด ReAct ๋ฃจํ"]
CH --> ASK
CH --> AG
ASK --> LLM["LLM<br/>๊ฒ์ดํธ์จ์ด ยท Anthropic ยท Ollama"]
AG --> LLM
LLM --> A(["๋ต๋ณ + ๊ทผ๊ฑฐ"])
end
subgraph SERVE["์๋น์ค"]
API["api.py<br/>FastAPI ยท SSE ยท Basic Auth"] --> A
API --> HIST[("chat_history.sqlite")]
API --> SC[("summary_cache.sqlite")]
end
| ์์ญ | ์ ํ | ์ |
|---|---|---|
| ์๋ฒ ๋ฉ | BAAI/bge-m3 (sentence-transformers, ๋ก์ปฌ) | ํ๊ตญ์ด+์์ด๊ฐ ์์ธ ํ๋ฉด ํ ์คํธ์ ๊ฐํจ. e5-largeยทko-sroberta์ ๊ณจ๋ ์ ์ผ๋ก ์ค์ธก ๋น๊ต ํ ์ ์ง |
| ๋ฒกํฐ DB | ChromaDB PersistentClient (cosine) | app/hour/date where ํํฐ๊ฐ ํ์. ์๋ฒ ๋๋๋ผ ๊ฐ์ธ์ฉ์ ์ด์ ๋ถ๋ด 0 |
| LLM | ๊ฒ์ดํธ์จ์ด ยท Anthropic ยท Ollama 3์ค ์ค์์น | ํ๊ฒฝ๋ณ์ ํ ์ค๋ก ์ ํ/๋กค๋ฐฑ. ๋ฒค๋ ์ฅ์ ยทํฌ๋ ๋ง ์์ง ๋๋น |
| ์์ด์ ํธ ๋ชจ๋ธ | ๋ฉํฐํด ๊ฒฝ๋ก๋ง ๋ชจ๋ธ ๋ถ๋ฆฌ | ๊ฒ์ดํธ์จ์ด๊ฐ Gemini์ thought_signature๋ฅผ ๋๋ฝ์์ผ 2ํด๋ถํฐ 400 ์๋ฌ โ ์ฝ๋๋ก ๋ชป ๊ณ ์น๋ ๋ฌธ์ |
| ์๋ฒ | FastAPI + uvicorn + SSE | ๋ ์ง๋ณ ์์ฝ์ asyncio.as_completed๋ก ๋จผ์ ๋๋ ๊ฒ๋ถํฐ + ๊ฒ์์ ํ ํฐ ๋จ์ SSE |
| ์ค์ผ์คํธ๋ ์ด์ | LangGraph StateGraph + ์ปค์คํ ReAct | ๊ณ ์ ๋ถ๊ธฐ์ ํด๋ฐฑ ๋ฃจํ๋ฅผ ํ ์ํ ๊ธฐ๊ณ๋ก. ์คํธ๋ฆฌ๋ฐ ์ด๋ฒคํธ๋ฅผ ๋ ธ๋์์ ์ง์ ๋ฐฉ์ถ |
| ์ ์ฅ | sqlite ร3 (์๋ณธ ro / ๋ํ / ์์ฝ ์บ์) |
๋จ์ผ ๋ ธ๋ ๊ฐ์ธ ๋๊ตฌ์ ๋ณ๋ DB ์๋ฒ๋ ๊ณผํจ |
| ๋ฐฐํฌ | Docker + GitHub Actions + GHCR + EC2 | git push ํ ๋ฒ์ผ๋ก ์ด๋ฏธ์ง ๋น๋ โ SSH ์ฌ๋ฐฐํฌ |
๋ช ์ด๋ง๋ค ๊ฑฐ์ ๊ฐ์ ํ๋ฉด์ด ์ฐํ๊ธฐ ๋๋ฌธ์ ํ๋ ์์ ๊ทธ๋๋ก ์๋ฒ ๋ฉํ๋ฉด ๋ฌด์์ ๋ฌผ์ด๋
์ฌ์ด๋๋ฐ ๋ฉ๋ด๊ฐ 1๋ฑ์ผ๋ก ์กํ๋ค. clean.py๊ฐ ์ธ ๊ฐ์ง๋ฅผ ํ๋ค.
flowchart LR
F1["ํ๋ ์ ร2,215<br/>๊ฑฐ์ ๊ฐ์ ํ๋ฉด"] --> G["group_frames()<br/>์ฑ+์ฐฝ ์ฐ์ ๋ฌถ๊ธฐ"]
G --> S["split_group()<br/>Jaccard 0.3 ๋ฏธ๋ง์ด๊ฑฐ๋ 2,000์ ์ด๊ณผ๋ฉด ๋ถํ "]
S --> E["์ด๋ฒคํธ ร1,164<br/>์ค๋ณต ์ ๊ฑฐ๋ ๋ณธ๋ฌธ"]
- ๋ฌถ๊ธฐ โ ์ฑ+์ฐฝ์ด ๊ฐ์ ์ฐ์ ํ๋ ์๋ง ํ ๋ฉ์ด๋ฆฌ๋ก. ์นดํก โ ํฌ๋กฌ โ ์นดํก์ด๋ฉด ์นดํก ๊ทธ๋ฃน์ด ๋ ๊ฐ๋ค. ์๊ฐ์ด ๋จ์ด์ง ๊ฑธ ํฉ์น๋ฉด "์ธ์ "๊ฐ ๋ญ๊ฐ์ง๋ค.
- ์ค์ด๊ธฐ โ ๊ทธ๋ฃน ์ ์ฒด์์ ์ด๋ฏธ ๋ณธ ์ค์ ๋ฒ๋ฆฐ๋ค. ์ด๋ฒคํธ๋ง๋ค
seen์ ๋น์ฐ๋ฉด ์ฌ์ด๋๋ฐ ๊ฐ์ ๋ฐ๋ณต ์ค์ด ์ด๋ฒคํธ๋ง๋ค ๋์ด์๋๋ค. - ๋๋๊ธฐ โ ์ฐฝ ์ ๋ชฉ์ด ์ ๋ฐ๋๋ ์ฑ(Claude, Code)์์๋ ์๋ก ๋ค๋ฅธ ์์ ์ด ํ ๊ทธ๋ฃน์ ๋ค ๋ค์ด์จ๋ค. Jaccard ๊ฒน์นจ์ด ์๊ณ ๋ฏธ๋ง์ด๊ฑฐ๋ ๊ธ์ ์ ์ํ์ ๋์ผ๋ฉด ๋๋๋ค.
2026-08-02 ์ค์ ๊ธฐ๋ก: ํ๋ ์ 2,215๊ฐ(7,482,811์) โ ์ด๋ฒคํธ 1,164๊ฐ(1,933,257์), ๊ธ์ โ75%
index.py๋ id๋ฅผ ๋ด์ฉ ํด์(app|window|start|text)๋ก ๋ง๋ ๋ค.
์ฌ์คํํด๋ ์ค๋ณต์ด ์ ์์ด๊ณ , 200๊ฐ ๋จ์ ์ฒดํฌํฌ์ธํธ๋ผ ์ค๊ฐ์ ์ฃฝ์ด๋ ์ด์ด์ ์์ธํ๋ค.
router.py์ route()๊ฐ JSON Schema ๊ตฌ์กฐํ ์ถ๋ ฅ ํ ๋ฒ์ผ๋ก
์๋๋ฅผ ์ ๋ถ ๋ฝ๋๋ค.
| ํ๋ | ํ๋ ์ผ |
|---|---|
app / site |
๊ฒ์์ ์ขํ๋ ํํฐ. enum์ผ๋ก ๊ฐ์ โ ์ฝํผ์ค์ ์๋ ์ฑ์ ์ง์ด๋ด๋ ๊ฑธ API ๋ ๋ฒจ์์ ์ฐจ๋จ |
hour_range |
์๊ฐ์ด ์ค์ ๋ก ์ธ๊ธ๋์ ๋๋ง. ํ์ฑ ํ 0~23 ๋ฒ์๋ฅผ ์ฝ๋๊ฐ ์ฌ๊ฒ์ฆ |
periods |
๊ธฐ๊ฐ์ ๋ฆฌ์คํธ๋ก. ํ๋ฃจ์ง๋ฆฌ๋ ๊ธฐ๊ฐ 1๊ฐ๋ก ํต์ผํด์ ์ดํ ๋จ๊ณ์ ์ด์ค ํํ์ ์์ฐ |
intent |
๊ฒ์ / ์ ๋ฆฌ / ๋น๊ต / ์ง๊ณ |
search_query |
ํ์ ์ง๋ฌธ("์ต๊ทผ ์ผ์ฃผ์ผ๋ก ๋ํ์ค")์ ์ด์ ๋ํ์ ์ฃผ์ ๋ฅผ ํฉ์ณ ๋ค์ ์ด ๊ฒ์ ๋ฌธ์ฅ |
count_by_site |
์ง๊ณ๋ฅผ ์ฑ ๋จ์๊ฐ ์๋๋ผ ๋ฐฉ๋ฌธ ๋๋ฉ์ธ ๋จ์๋ก |
compound |
์์ด์ ํธ ํด๋ฐฑ ์ฌ๋ถ. ์ ์ฉ ํ๋ณ ํธ์ถ์ ์์ ๊ณ ์ด ํ๋ ํ๋๋ก ํฉ์ณ ์ง๋ฌธ๋น LLM 1ํ๋ฅผ ์ค์๋ค |
๋ณตํฉ ์ง๋ฌธ์ ์ํด ReAct ๋ฃจํ๋ฅผ ์น์ผ๋ฉด์, ์ด๋ฏธ ๊ฒ์ฆ๋ ๊ณ ์ ๊ฒฝ๋ก๋ฅผ ๋ง๊ฐ๋จ๋ฆฌ์ง ์๋๋ก ์ค๊ณํ๋ค. (graph.pyยท
agent.py)
flowchart TD
Q(["์ง๋ฌธ"]) --> C{"plan.compound?"}
subgraph FIXED["๊ณ ์ ๊ฒฝ๋ก โ graph.py"]
R2["route ๋
ธ๋"] -.-> N1["search / single_period<br/>multi_period / fallback"]
end
subgraph LOOP["์์ด์ ํธ ๋ฃจํ โ agent.py"]
AG["agent ยท LLM์ด ๋๊ตฌ ์ ํ"] --> TL["tools ยท ์คํ"]
TL -. "๋ ํ์ํ๋ฉด" .-> AG
end
C -- "์๋์ค (๋๋ถ๋ถ)" --> FIXED
C -- "์ (๊ฐ๋)" --> LOOP
FIXED --> A(["๋ต๋ณ"])
AG -- "์ถฉ๋ถํ๋ฉด" --> A
- ๋๊ตฌ๋ ์ ๋ก์ง์ ์ง์ง ์๋๋ค. 6๊ฐ ๋๊ตฌ(
search_events/count_events/summarize_days/compare_days/draft_handover_doc/draft_slack_message) ์ ๋ถ ๊ธฐ์กด ํจ์๋ฅผ ๊ฐ์ธ์ ๊ตฌํํ๋ค. - ๊ฐ๋๋ ์ผ: ํ์ดํธ๋ฆฌ์คํธ 6๊ฐ +
recursion_limit=8. ํ๋๋ฅผ ๋๊ธฐ๋ฉด ์ฌ์๋ ๋์ ์๋ด ๋ฌธ๊ตฌ๋ก ๋๋ธ๋ค. - ๋๋๋ฆด ์ ์๋ ํ๋์ ๋๊ตฌ๊ฐ ์๋๋ค. ์ฌ๋ ์ด์์ LLM์ด ๋ง๋ค์ง๋ง ์ค์ ์ ์ก์ ์ฌ์ฉ์๊ฐ ๋ฒํผ์ ๋๋ฌ์ผ๋ง ํธ์ถ๋๋ ๋ณ๋ ์๋ํฌ์ธํธ๋ค. "์น์ธ๋ ๊ฒ ๊ฐ๋ค"๋ ์ถ๋ก ์ผ๋ก ๋ฉ์์ง๊ฐ ๋๊ฐ๋ฉด ์ ๋๋ฏ๋ก ์๋ ์น์ธ ๊ฐ์ง๋ ์ผ๋ถ๋ฌ ๋ฃ์ง ์์๋ค.
- ์ง์ ๋ต๋ณ ์ฌ์ฌ์ฉ์ LLM์ด ์๋๋ผ ์ฝ๋๊ฐ ํ๋ค. "๊ทธ๊ฑฐ ์ฌ๋์ผ๋ก ๋ณด๋ด์"๋ ์ฌ์กฐํ
ํํฐ๋ฅผ LLM์ด ๋ค์ ์ถ๋ก ํ๋ค ๋ฌด๊ดํ ๋ด์ฉ์ ๋ง๋ ์ฌ๊ณ ๊ฐ ์์ด์,
InjectedState๋ก ๋ํ ๊ธฐ๋ก์ ๋๊ตฌ์ ๋ฃ์๋ค.
api.py๊ฐ ํ๊ฒฝ๋ณ์ ํ ์ค๋ก ๊ณ ๋ฅด๋ฏ๋ก A/B๋ ๋กค๋ฐฑ์ด๋ ์ฝ๋ ๋ฐฐํฌ ์์ด ๋๋๋ค.
| ๊ตฌํ | ๋ฌด์์ ์๋ก ์งฐ๋ | ๋ฌด์์ ๊ทธ๋๋ก ์ผ๋ |
|---|---|---|
screenlog (์๋ณธ) |
์ ๋ถ | โ |
screenlog_langchain |
LLM ํธ์ถ๋ง (with_structured_output, LCEL prompt | llm | parser) |
๋ฐ์ดํฐ ๊ณ์ธต ์ ๋ถ |
screenlog_langgraph |
์ค์ผ์คํธ๋ ์ด์ ๋ง (StateGraph ๋ถ๊ธฐ, ์ปค์คํ ์คํธ๋ฆผ, ReAct) | ํ๋กฌํํธยท๊ฒ์ยท์์ฝยท์บ์ ์ ๋ถ |
LangChain ๋ฒ์ ์์ ๋ถ๊ธฐ๋ฅผ RunnableBranch๋ก ์ ์ฎ๊ธด ์ด์ ๋ ๋จ๊ฒผ๋ค โ route() ํ ๋ฒ์ผ๋ก
ํ์ ๋๊ณ ์ฌํ๋จ์ด ์๋ ๊ณ ์ ํ๋ฆ์ด๋ผ, ์ฒด์ธ์ผ๋ก ๊ฐ์ผ๋ค๊ณ ๋ ๋ช
ํํด์ง์ง ์๋๋ค๊ณ ํ๋จํ๋ค.
| ๋จ๊ณ | app | hour | date |
|---|---|---|---|
| 3๋จ๊ณ (๊ท์น ๋ผ์ฐํ ) | 15/15 | 15/15 | 15/15 |
| 4๋จ๊ณ (LLM ๊ตฌ์กฐํ ์ถ๋ ฅ) | 18/18 | 18/18 | 18/18 |
3๋จ๊ณ์ 15/15์๋ ํธํฅ์ด ์๋ค โ ์ง๋ฌธ๊ณผ ๊ท์น์ ๊ฐ์ ์ฌ๋์ด ๊ฐ์ ์ฝํผ์ค๋ฅผ ๋ณด๊ณ ๋ง๋ค์๋ค.
๊ทธ๋์ ์ฌ์ ์ ์๋ ํํ("ํ์ํ์ ์ฑ", "ํ์ผ ๊ด๋ฆฌ์", "์")์ ์ถ๊ฐํด ์ฌ๊ฒ์ฆํ๊ณ , ๊ทธ ๊ณผ์ ์์
LLM์ด ๋ด์ฉ ์ง๋ฌธ์ ์๋ ์ฑ์ ์ง์ด๋ด๋ ๋ฒ๊ทธ๋ฅผ ๋จผ์ ์ก์๋ค.
โ eval/routing/REPORT.md ยท docs/routing-verification.md
๋ผ๋ฒจ๋ง ๋๊ตฌ(label_retrieval.py)๋ถํฐ ์์ํ๋ค.
| k | 5 | 6 | 7 | 8 | 9 | 10 | 20 |
|---|---|---|---|---|---|---|---|
| ํ๊ท recall | 0.86 | 0.89 | 0.93 | 0.99 | 0.99 | 1.00 | 1.00 |
โ RETRIEVE_K๋ฅผ 10์์ 8๋ก ๋ฎ์ท๋ค. recall 1%p๋ฅผ ๋ด์ฃผ๊ณ ํ๋กฌํํธ ๊ทผ๊ฑฐ๋ฅผ 20% ์ ๊ฐํ
ํธ๋ ์ด๋์คํ๋ค.
"์ฝํผ์ค๊ฐ ์ปค์ง๋ฉด ํ์ด๋ธ๋ฆฌ๋ ๊ฒ์์ด ํ์ํ๋ค"๋ ๋ก๋๋งต์ ๊ฐ์ ์ ๊ฒ์ฆํ๋ค. 7๊ฐ ๋ฐฉ๋ฒ์ ํ๋์ ์คํฌ๋ฆฝํธ, ๊ฐ์ ์ฑ์ ํจ์๋ก ํต์ผํด์ ์๋ค.
| ๋ฐฉ๋ฒ | R@5 | P@5 | F1@5 | R@10 | F1@10 |
|---|---|---|---|---|---|
| dense (ํ๋ก๋์ ) | 0.95 | 0.60 | 0.69 | 1.00 | 0.62 |
| bm25 | 0.63 | 0.34 | 0.42 | 0.71 | 0.34 |
| bm25 + ์ฟผ๋ฆฌ ํ์ฅ | 0.55 | 0.26 | 0.33 | 0.68 | 0.33 |
| ํ์ด๋ธ๋ฆฌ๋ (dense+bm25, RRF) | 0.94 | 0.50 | 0.61 | 0.97 | 0.47 |
| ํ์ด๋ธ๋ฆฌ๋ (ํ์ฅ ์ฟผ๋ฆฌ) | 0.89 | 0.50 | 0.60 | 0.97 | 0.49 |
| ๋ฆฌ๋ญ์ปค (cross-encoder) | 0.93 | 0.63 | 0.69 | 0.96 | 0.64 |
| HyDE | 0.68 | 0.35 | 0.44 | 0.80 | 0.39 |
์ฌ๊ธฐ์ ์ ์ผ ์ค์ํ ๊ฑด ๋ฆฌ๋ญ์ปค๋ค. ํ๊ท F1์ด dense์ ์ ํํ ๊ฐ์์ "์ฐจ์ด ์์"์ผ๋ก ๋์ด๊ฐ ๋ปํ๋๋ฐ, ๋ฌธํญ๋ณ๋ก ๋ฏ์ด๋ณด๋ ๋๋ฅ ์ด ์๋์๋ค.
| ์ง๋ฌธ | dense | ๋ฆฌ๋ญ์ปค | ๋ฌด์จ ์ผ์ด |
|---|---|---|---|
| ์ ๋ต์ด ํ๋๋ฟ์ธ ์ง๋ฌธ(r15) | 0.50 | 1.00 | ํฌ๊ฒ ๊ฐ์ |
| ์ ๋ต์ด ์ฌ๋ฌ ํ์ด์ง์ธ ์ง๋ฌธ(r08) | 1.00 | 0.33 | ํฌ๊ฒ ์ ํ |
cross-encoder๊ฐ "๊ฐ์ฅ ๊ทธ๋ด๋ฏํ ํ๋"๋ก ์๋ ดํด์, ์ ๋ต์ด ๊ฐ๋ฆฌ๋ ์ง๋ฌธ์ ๋๋จธ์ง๋ฅผ ์์ ๋ฐ์ผ๋ก ๋ฐ์ด๋๋ค. ํ๊ท ์ด ๊ฐ์๋ ๊ฑด ๊ฐ์ ๋ถ๊ณผ ์ ํ๋ถ์ด ์ฐ์ฐํ ์์๋ ๊ฒฐ๊ณผ์๋ค โ ๋์ ๋ณด๋ฅ.
์๋ฒ ๋ฉ ๋ชจ๋ธ๋ ๋ฐ๊ฟ๋ดค๋ค. bge-m3 F1@5 0.69 / multilingual-e5-large 0.50 / ko-sroberta 0.37 โ ํ๊ตญ์ด ์ ์ฉ ๋ชจ๋ธ์ด ๋ค๊ตญ์ด ๋ชจ๋ธ์ ๋ชป ๋ฏธ์ณค๋ค. ํ๋ฉด ์บก์ฒ์ ์์ด UI ๋ฌธ์์ดยท๊ณ ์ ๋ช ์ฌ๊ฐ ์์ฌ ์์ด ํ๊ตญ์ด ํนํ๋ณด๋ค ๋ค๊ตญ์ด ์ปค๋ฒ๋ฆฌ์ง๊ฐ ๋ ์ค์ํ ๊ฒ์ผ๋ก ๋ณด์ธ๋ค.
ํ๊ท ๋ง ๋ณด๊ณ ์ฑํํ๋ค๋ฉด ํน์ ์ง๋ฌธ ์ ํ์ด ์กฐ์ฉํ ๋ง๊ฐ์ก์ ๊ฒ์ด๋ค. ๊ทผ๊ฑฐ:
eval/retrieval/RETRIEVAL_REPORT.md
4. ๋ก์ปฌ LLM์ ๊ฒฐํจ์ ํ์ธํ๋๊ณผ ์ํคํ ์ฒ, ๋ ๊ฐ์ง๋ก ๊ฐ๊ฐ ๊ณ ์ณ์ ๋น๊ตํ๋ค
๋ก์ปฌ ๋ชจ๋ธ(Qwen2.5-7B)์ด "ํ๋ฃจ ์ ๋ฆฌ" ์ง๋ฌธ์์ ํ๋ฃจ์ ๋๋ถ๋ถ์ ๋๋ฝํ๋ ๋ฌธ์ ๋ฅผ ์ค์ธกํ๋ค (8/3, ์ด๋ฒคํธ 3,190๊ฐ ์ค 5๊ฐ๋ง ๋ตํจ). ๋ชจ๋ธ์ ํค์๋(14B), ๊ณ์ด์ ๋ฐ๊ฟ๋(Llama) ์ ๊ณ ์ณ์ก๋ค โ 7~14B๊ธ ๊ณตํต์ ํ๊ณ๋ผ๋ ๊ฒฐ๋ก ์ ๋๋ฌํ ๋ค, ๋ ๋ฐฉํฅ์ผ๋ก ๊ฐ๊ฐ ํด๊ฒฐํด์ ๋น๊ตํ๋ค.
| ํด๋ฒ | ๋ฐฉ์ | ์ปค๋ฒ๋ฆฌ์ง(์๋ณธ โ ํด๋ฒ ์ ์ฉ, GOLD ๋๋น) |
|---|---|---|
| LoRA ํ์ธํ๋ | 68๊ฐ ์ง์ ์ฆ๋ฅ ๋ฐ์ดํฐ๋ก ๋ชจ๋ธ ํ๋ ์์ฒด๋ฅผ ๊ต์ | 0.02 |
| ํ๋กฌํํธ ๋ถํ | ์๊ฐ๋๋ณ map-reduce, ๋ชจ๋ธ์ ๊ทธ๋๋ก(ํ์ต ์์) | 0.02 |
๋ถํ ์ชฝ์ ๋ธ๋ก๋ณ ๊ฒฐ๊ณผ๋ฅผ ๋จ์ํ ์ด์ด๋ถ์ด์ ํ ๋ธ๋ก์ด ์ค๊ตญ์ด๋ก ๋ตํ๋ ์ค์ผ์ด ํ์ ๊ธฐ๋ฅ(๋น๊ตยท์ฌ๋ ์ด์)๊น์ง ์ ํ๋๊ณ , "ํต์งธ๋ก ๋ค์ ์ ๋ฆฌ(reduce)"๋ก ๊ณ ์น๋ ค ํ์ ๊ทธ ํธ์ถ ์์ฒด๊ฐ ๊ธด ์ปจํ ์คํธ๋ผ recency bias๋ฅผ ์ฌ๋์ ํด ์ปค๋ฒ๋ฆฌ์ง๊ฐ ๋๋ก ๋๋น ์ก๋ค(1.00โ0.19). ์ค์ผ๋ ๋ธ๋ก๋ง ๊ณจ๋ผ ์ฌ์๋ํ๋ ๋ฐฉ์์ผ๋ก ๋ฐ๊พธ๊ณ ๋์์ผ ์์ ๋๋ค.
LoRA ์ชฝ์ "์๋ฌ ์์ด ์กฐ์ฉํ ๋ง๊ฐ์ง๋" ํจ์ ๋ค์ด ์กด์ฌํ๋ค โ ํ๋กฌํํธ ์ค์๊ฐ์ด 14,394ํ ํฐ์ด๋ผ
ํํ ๊ธฐ๋ณธ๊ฐ(max_length=8192)์ผ๋ก ์๋์ผ๋ฉด 68๊ฐ ์ค 46๊ฐ์์ ํ์ต ์ ํธ๊ฐ 0์ด ๋์ ๊ฒ์ด๊ณ ,
ํ ํฐํ ๊ฒฝ๊ณ๊ฐ ๋ฐ๋ ค ๋ง์คํน์ด ์ด๊ธ๋ ๊ฒ๋ assert๋ฅผ ์คํจ์์ผ์ ์ฐพ์๋ค. 16K ์ํ์ค OOM์
๋๋ถ๋ถ logits๋ง ๊ณ์ฐํ๋ TailLossTrainer๋ฅผ ์ง์ ๊ตฌํํ๊ณ ๊ธฐ๋ณธ ๊ตฌํ๊ณผ ์์ค์ด 1e-6 ์ค์ฐจ ๋ด
๋์ผํจ์ ๊ฒ์ฆํ ๋ค ๋ฐ์ํ๋ค.
๊ทผ๊ฑฐ:
docs/local-llm-experiment-report.mdยทeval/lora/ยทeval/summary_chunking/
์ ์ฒด ๊ธฐ๋ก์ **์ค๊ณ ๊ฒฐ์ ๋ฌธ์**์ ์๋ค. ์ฌ๊ธฐ์๋ ๋๋ง.
| ๋งก๊ฒผ๋๋ | ์ค์ ๊ฒฐ๊ณผ | ์กฐ์น |
|---|---|---|
| ์ฌ์ฉ ํ์ ์ธ๊ธฐ | ์ค์ 340ํ๋ฅผ "5ํ" ๋ก ๋ตํจ | count_range() โ metadata๋ฅผ ์ฝ๋๊ฐ ์ง์ ์
|
| ์์ผ ๊ณ์ฐ | 7/27์ ์ผ์์ผ์ด๋ผ๊ณ ๋ตํจ | ์์ผ์ ๋ฏธ๋ฆฌ ๊ณ์ฐํด ํ๋กฌํํธ์ ์ฃผ์ |
| "์ด์ "๊ฐ ๋ฉฐ์น ์ธ์ง | ์ ํํ ๊ทผ๊ฑฐ๋ฅผ ์์ ๋๊ณ "๊ธฐ๋ก์ ์๋ค" | today ์ฃผ์
+ ์ฌ๊ณ์ฐ ๊ธ์ง ์ง์ |
| ์ฑ ์ด๋ฆ ์ถ๋ก | ์ฝํผ์ค์ ์๋ ์ฑ์ ์ง์ด๋ | JSON Schema enum์ผ๋ก API ๋ ๋ฒจ์์ ์ฐจ๋จ |
| URL ์ธ์ฉ | ์์ ์ ๋ชฉ์ ๋ถ์ฌ ๊ฐ์ง ๋งํฌ ์์ฑ | ์ด๋ฒคํธ์ ์ค์ url์ ์ ์ฅํด ๊ทผ๊ฑฐ์ ๊ฐ์ด ๋ฃ์ |
LLM์ ๋ฌธ์ฅ์ ์ฐ๊ณ , ์ธ๊ณ ๊ฑฐ๋ฅด๋ ์ผ์ ์ฝ๋๊ฐ ํ๋ค.
config.py์ ๋ชจ์ฌ ์๊ณ , ์ ๋ถ ๊ทผ๊ฑฐ ์ฃผ์์ด ๋ถ์ด ์๋ค.
| ๊ฐ | ์ค์ | ์ ์ด ๊ฐ์ธ๊ฐ |
|---|---|---|
RETRIEVE_K |
8 | ๊ณจ๋ ์ recall@8 = 0.99, @10 = 1.00. 1%p๋ฅผ ์ฃผ๊ณ ํ๋กฌํํธ ๊ทผ๊ฑฐ 20% ์ ๊ฐ |
JACCARD_MIN |
0.3 | 0.1/0.3/0.5 ์ค์์์ recall ์ฐจ์ด ์์ โ ๊ธฐ๋ณธ๊ฐ ์ ์ง (ํ๋ณธ ํ๊ณ๋ ๊ธฐ๋ก) |
| ๊ฒ์ ์ ๋ต | dense ๋จ๋ | 6์ข ๋์ ์ ๋ถ dense๋ฅผ ๋ชป ์ด๊น |
CONTEXT_CHARS_PER_HIT |
1500 | ์ด๋ฒคํธ ํฌ๊ธฐ๊ฐ ๊ณ ๋ฅด์ง ์๋ค(์ค์๊ฐ 1,270์, ์ต๋ 36,870์) |
MAX_EVENTS_PER_DAY_SUMMARY |
60 | ์ํ ์์ด ๋๋ ธ๋๋ ํ๋ฃจ ์์ฝ ํ๋กฌํํธ๊ฐ 1,005,356์ โ 22,730์ |
MAX_PERIOD_SEARCH_K |
50 | ๊ธฐ๊ฐ ์๋ ๊ฒ์์ k=8์ด๋ฉด ๊ด๋ จ ์ด๋ฒคํธ๊ฐ ๋ฐ๋ ค์ ํต์งธ๋ก ๋๋ฝ |
EMBED_BATCH_SIZE |
4 | ๊ธฐ๋ณธ๊ฐ 32๋ฉด MPS OOM. ํ๋ฉด ํ ์คํธ ํ ๊ฑด์ด ๊ธธ๋ค |
HISTORY_TURNS |
2 | 5ํด์ ํ์คํ ๋ฆฌ๊ฐ ์ปค์ ธ ํ ๋ฃจ์๋ค์ด์ ์ด ๋์๋ค |
IDLE_GAP_SEC |
120 | ์ด๋ฒคํธ start/end๋ง ์ฐ๋ฉด 93%๊ฐ ํญ 0. 2๋ถ ์ด๊ณผ ๊ณต๋ฐฑ์ ์๋ฆฌ ๋น์์ผ๋ก ์ฒ๋ฆฌ |
AI_APPS |
{Claude, Code} |
์ฌ๊ท ์ค์ผ ๊ฒฉ๋ฆฌ (์๋) |
ํ๋กฌํํธ ์ํ์ ๊ฑธ ๋ ์์๋ฅด๊ธฐ ๋์ ์ผ์ ๊ฐ๊ฒฉ ์์๋ด๊ธฐ(_thin_out())๋ฅผ ์ด ์ด์ ๋
๊ฐ์ ์ฑ๊ฒฉ์ด๋ค โ ์์์ ์๋ฅด๋ฉด ํ๋ฃจ์ ์ค์ ๋ง ๋จ๊ณ ์คํยท์ ๋
์ด ํต์งธ๋ก ์ฌ๋ผ์ง๋ค.
23๊ฑด ์ ์ฒด๋ docs/troubleshooting-star.md์ STAR ํ์์ผ๋ก ์๋ค.
๋ฌธ์ โ ๋ฌด๊ดํ ์ง๋ฌธ์ LLM์ด ์กด์ฌํ์ง ์๋ ์๊ฐ๊ณผ ์ด๋ฒคํธ๋ฅผ ๊ทผ๊ฑฐ๋ก ์ธ์ฉํ๋ค. ๊ฒ์์ ์ ์์ด์๊ณ ํ๋กฌํํธ๋ ์ ์์ด์๋๋ฐ ๋ต๋ง ํ๋ ธ๋ค.
์์ธ โ ๊ทผ๊ฑฐ๋ฅผ ํ๋์ฉ ์ด์ด๋ณด๋, ์ด ๋๊ตฌ๊ฐ ๋๋ฒ๊น ํ๋ฉฐ ํฐ๋ฏธ๋ยท์๋ํฐ์ ์ถ๋ ฅํ ์์ฝ๋ฌธ์ด ํ๋ฉด ์บก์ฒ๋ก ๋ค์ ์์ธ๋์ด ๊ฒ์ ํ๋ณด์ ์ฌ๋ผ์ ์์๋ค. RAG๊ฐ ์๊ธฐ ์ถ๋ ฅ์ ์ฌ์ค๋ก ๋์ฝ๊ณ ์์๋ ๊ฒ์ด๋ค.
ํด๊ฒฐ โ 3๋จ๊ณ๋ก ๋ง์๋ค.
โ AI ๋๊ตฌ ์ฑ(Claude, Code)์ ๊ฒ์ ํ๋ณด์์ ์ ์ธ
โก ๋จ ์ฌ์ฉ์๊ฐ ๊ทธ ์ฑ์ ๋ช ์์ ์ผ๋ก ๋ฌผ์ผ๋ฉด("์ฝ๋ฉ ๋ช ์๊ฐ ํ์ด?") ์์ธ โ ์ ๋นํ ์ง๋ฌธ๊น์ง ๋ง์ผ๋ฉด ์ ๋๋ฏ๋ก
โข ๊ทธ๋๋ ๊ฑธ๋ฆฐ ๊ทผ๊ฑฐ๋ API ์๋ต์ ai_app: true๋ก ํ์ํด
์ฌ์ฉ์๊ฐ ํ ๋ฒ ๋ ์์ฌํ ์ ์๊ฒ ํ๋ค.
์๊ธฐ ์์ ์ ๊ด์ธกํ๋ ์์คํ ์์๋ง ๋์ค๋ ์ค์ผ์ด๋ผ, ์ผ๋ฐ์ ์ธ RAG ์ฒดํฌ๋ฆฌ์คํธ์๋ ์๋ค. ์์ ์ฐจ๋จ์ด ์๋๋ผ "๊ฒฉ๋ฆฌ + ํ์"๋ฅผ ํํ ์ด์ ๋, ์์ธ ์์ฒด๋ฅผ ์์ ๊ธฐ๋ ์ด๋ ค์ ๊ธฐ ๋๋ฌธ์ด์๋ค.
๋ค๋ฅธ 5๊ฑด โ ์ฆ์ / ์ง์ง ์์ธ / ์ค์ํ๋ ๊ฒ
| ์ฆ์ | ์ง์ง ์์ธ | ํด๊ฒฐ ๊ณผ์ ์์ ์ค์ํ๋ ๊ฒ |
|---|---|---|
| ์์ธ์ด 20๋ถ โ ์์ 21์๊ฐ | ์์ธ์ด 4๊ฒน: Docker Desktop VM์ 8GB ์์ ์์ฝ + Ctrl+Z๋ก ๋ฐฉ์น๋ ์ข๋น ํ๋ก์ธ์ค 3๊ฐ(๋ชจ๋ธ ์ค๋ณต ๋ก๋ฉ) + ๋ฐฐ๊ฒฝ ํ๋ก์ธ์ค + ๋ฌผ๋ฆฌ 16GB ํ๊ณ | ๊ฐ์ค์ ํ๋์ฉ ์์น๋ก ๋ฐ์ฆ. "๋ฐ์ดํฐ๊ฐ ๋์๋"๋ DB ์ฟผ๋ฆฌ๋ก, "GPU ๋ฌธ์ ์ธ๊ฐ"๋ ๊ฒฉ๋ฆฌ ๋ฒค์น๋งํฌ๋ก ์ง์ ๋ค โ 8๋ฐฐ ๊ฐ์ |
| ๋ณตํฉ ์ง๋ฌธ ํ๋ณ๊ธฐ๊ฐ ํญ์ False | except Exception: return False๊ฐ ๋งค ํธ์ถ์ API 400์ ์กฐ์ฉํ ์ผํค๊ณ ์์๋ค |
ํด๋ฐฑ์ ๊ฑท์ด๋ด๊ณ ์์ ์์ธ๋ฅผ ์ง์ ๋ดค๋ค. ๊ณ ์น๋ ์ด๋ฒ์ ๋ณ๋ ฌ ๋๊ตฌ ํธ์ถ๋ก chromadb ๊ฒฝ์ ์ํ๊ฐ ๋๋ฌ๋ Lock์ผ๋ก ํด๊ฒฐ โ ์ ์คํ ๊ฒฝ๋ก๋ ๊ธฐ์กด ์ฝ๋์ ์๋ฌต์ ์ ์ ๋ฅผ ๊นฌ๋ค |
| ๋ฉํฐํด ๋๊ตฌ ํธ์ถ์ด 2๋ฒ์งธ ํด์์ 400 | ๊ฒ์ดํธ์จ์ด๊ฐ Gemini ์๋ต์ OpenAI ํฌ๋งท์ผ๋ก ๋ณํํ๋ฉฐ thought_signature๋ฅผ ๋๋ฝ โ ์ฌ์ ์กํ ๊ฐ์ด ์ ์ด์ ๋๋ฌํ์ง ์์ |
git stash๋ก ๋ด ๋ณ๊ฒฝ์ ๋ฐฐ์ ํด ๋ฒ์๋ฅผ ์ขํ ๋ค ์๋ณธ ์๋ต์ ์ง์ ์ด์ด๋ดค๋ค. ์ฝ๋๋ก ๋ชป ๊ณ ์น๋ ๋ฌธ์ ๋ก ํ๋จํ๊ณ ํด๋น ๊ฒฝ๋ก๋ง ๋ชจ๋ธ ๋ถ๋ฆฌ |
| ์์ธํ ์๋ก ๋ฉ๋ชจ๋ฆฌ๊ฐ 15GB๊น์ง | MPS ์บ์ฑ ํ ๋น์๊ฐ ๊ธธ์ด๊ฐ ๋ค์ญ๋ ์ญํ ๋ฐฐ์น(100~36,870์)๋ง๋ค ์ ๋ธ๋ก์ ์๊ธฐ๋ง ํ๊ณ ๋ฐ๋ฉ ์ ํจ | ๋ฐฐ์น ํฌ๊ธฐ(32โ4)์ torch.mps.empty_cache(). ํ๋์จ์ด ํน์ฑ์ด ๋ฐ์ดํฐ ๋ถํฌ์ ๋ง๋ ์๊ธด ๋ฌธ์ |
| ํ๋ก๋์ API๊ฐ ์ธ์ฆ ์์ด ์ธํฐ๋ท์ ๋ ธ์ถ | "์ผ๋จ ๋์ฐ๊ณ ๋์ค์ ์ ๊ทธ์"๊ฐ ๊ทธ๋๋ก ๋จ์ | Basic Auth๋ฅผ ๋ถ์ด๋ ๋ฐ ๊ทธ์น์ง ์๊ณ , ํค๊ฐ ์์ผ๋ฉด ์๋ฒ๊ฐ ๊ธฐ๋ ์์ฒด๋ฅผ ๊ฑฐ๋ถํ๊ฒ ๋ง๋ค์ด ๊ฐ์ ์ค์์ ์ฌ์ง๋ฅผ ์์ด๋ค |
์บ์ ์ ์ค๊ณผ ๋ฌด๊ดํ๊ฒ ํญ์ ์ฌํ๋๋ ์ซ์์, ์ฌ์ ๊ณ์ฐ์ด ์์ด์ผ๋ง ๋์ค๋ ์ซ์๋ฅผ ๋๋ ์ ์ธก์ ํ๋ค.
| ํญ๋ชฉ | ์ | ํ (์บ์ ๋ฌด๊ด, ํญ์ ์ฌํ) | ์บ์ ์ ์ค ์ |
|---|---|---|---|
| "์ ๋ฒ์ฃผ ์ ๋ฆฌํด์ค" (7์ผ) | ~20์ด (์์ฐจ) | 6.4์ด (asyncio.gather) |
1.7~2.0์ด |
| "์ ๋ฒ์ฃผ vs ์ด๋ฒ์ฃผ" (14์ผ) | ~45์ด | ~10์ด | โ |
| ๋ธ๋ผ์ฐ์ ์ ์ถ โ ํ๋ฉด ์์ฑ(7์ผ ์ ๋ฆฌ) | ~20์ด | ~7์ด๋ | 4.6์ด (์ฒซ ๊ธ์ 2.0์ด) |
asyncio.gather()๋ ๊ทธ ์์์๋ ๋ณ๋ ฌ์ด์ง๋ง, ๋ฐ์์ ๋ณด๋ฉด ๊ฐ์ฅ ๋๋ฆฐ ํ๋ฃจ๊ฐ ์ ์ฒด ์๋ต
์๊ฐ์ ๊ทธ๋๋ก ๊ฒฐ์ ํ๊ณ ๊ทธ๋๊น์ง ์ฌ์ฉ์๋ ์๋ฌด๊ฒ๋ ๋ชป ๋ณธ๋ค. asyncio.as_completed()๋ก
๋ฐ๊ฟ ๋จผ์ ๋๋ ๋ ์ง๋ถํฐ ์คํธ๋ฆฌ๋ฐํ๋๋ก ๊ณ ์ณค๋ค.
| (๊ฐ์ 5์ผ์น, ์บ์ ์ฐํ) | ์ฒซ ํ ํฐ | ์ด ์๋ฃ ์๊ฐ |
|---|---|---|
์ (gather, ๋ค ๋๋์ผ ๋ฐํ) |
5.3~7.3์ด | 5.3~7.3์ด |
ํ (as_completed, ๋จผ์ ๋๋ ๊ฒ๋ถํฐ) |
1.4~1.9์ด | 5.0~5.2์ด |
์ด ์๋ฃ ์๊ฐ์ ๊ฑฐ์ ๊ทธ๋๋ก๋ค โ ํ๋ ์ผ์ ์ด๋์ ์ ์ค์์ผ๋ ๋น์ฐํ๋ค. ๋์
์ฒด๊ฐ ๋๊ธฐ ์๊ฐ์ด ์ฝ 4๋ฐฐ ๋น๊ฒจ์ก๋ค. ๋จ๋ฐ ๊ฒ์์ LLM์ ํ ๋ฒ๋ง ๋ถ๋ฅด๋ฏ๋ก ๊ฐ์ ํญ์ด ํจ์ฌ
์๋ค(์ฒซ ์ฝํ
์ธ 1.862.04์ด โ 1.121.17์ด, ~40%) โ ๋๋ ๊ฒ ์ฌ๋ฌ ๊ฐ ์์ด์ผ ์คํธ๋ฆฌ๋ฐ์ด
ํฌ๊ฒ ์ด๊ธด๋ค๋ ๊ฑธ ์ซ์๋ก ํ์ธํ๋ค.
๋ฐฑ์๋๋ฅผ ๋น ๋ฅด๊ฒ ๋ง๋ค์ ํ๋ก ํธ ํ์ดํ ์ ๋๋ฉ์ด์ ์ด ์ ๋ณ๋ชฉ์ด ๋๋ค โ 4,600์ ๋ต์ด ์ฆ์ ๋์ฐฉํด๋ 15ms๋ง๋ค 2๊ธ์์ฉ ๊ทธ๋ฆฌ๋๋ผ 30์ด๊ฐ ๊ฑธ๋ ธ๋ค. ๊ฐ์ ๊ณ์๋ฅผ ์ค์ธก(์์ 90ํฑ โ ์ค์ 380ํฑ)์ผ๋ก ๋ณด์ ํด์ 1.7์ด๋ก ๋ง์ท๋ค.
๊ณ ์ณ๋ดค๋ค๊ฐ ๋๋๋ฆฐ ๊ฒ๋ ๋จ๊ฒผ๋ค. "๋๊ธฐ search()๊ฐ ์ด๋ฒคํธ ๋ฃจํ๋ฅผ ๋ง๋๋ค"๋ ์ง๋จ์ผ๋ก
asyncio.to_thread()๋ฅผ ์ ์ฉํ๋๋ฐ, ๊ฒฉ๋ฆฌํด์ ์ฌ๋ณด๋ ์๋ฒ ๋ฉ+๊ฒ์์ 60~70ms๊ณ LLM ์์ฑ์ ~2์ด๋ผ
๋ง๊ณ ์๋ ์๊ฐ์ด ์ ์ฒด์ 3%๋ ์ ๋๋ค. ๊ทผ๊ฑฐ ์์ด ์ฝ๋๋ง ๋ณต์กํด์ ธ์ ๋๋๋ ธ๋ค.
โ docs/streaming-and-async.md ยท docs/summary-cache.md
์ธ ํ์ด์ง ๋ชจ๋ ์์กด์ฑ ์๋ ์ ์ HTML์ด๊ณ , ๊ณต์ ๋์์ธ ํ ํฐ(tokens.css)๋ง ๊ฐ์ด ์ฐ๋๋ก ํ๋ค.
| ํ์ด์ง | ๋ด์ฉ |
|---|---|
/ (๋๋ฉ) |
์๋น์ค ์๊ฐ ยท ๋ค์ด๋ก๋ ์ ๋. ์ธ์ฆ ์์ธ(์ ํํ /๋ง) |
/dashboard (๋ฌผ์ด๋ณด๊ธฐ) |
์ฑํ ยท ๋ผ์ฐํ ๋ฐฐ์ง ยท ๊ทผ๊ฑฐ ์นด๋ ยท ํ๋ ์๋ ยท ์ต๊ทผ ๊ธฐ๋ก ยท ์ด์ ๋ํ ์ฌ์ด๋๋ฐ |
/explore (ํ์) |
๋ ์ง๋ณ ์ฑ ์ฌ์ฉ ยท ํ๋ฃจ ๋ฆฌ๋ณธ ํ์๋ผ์ธ ยท ๊ฒ์ ํ๋ณด ํธ์ค(์์ ์ฑ์ด ํ๋ณด์ ๋ช %์ธ์ง) |
๋๋ฉ(
/) โ ํ ๋ฐฐํฌ์ฉ .dmg ๋ค์ด๋ก๋๊น์ง ์ฌ๊ธฐ์ ์ด์ด์ง๋ค. ์ธ์ฆ ์์ด ์ ๊ทผ ๊ฐ๋ฅํ๋ค.
| ์๋ํฌ์ธํธ | ์ค๋ช |
|---|---|
POST /api/ask |
์ง๋ฌธ โ ๋ต๋ณ + ๋ผ์ฐํ ๊ณํ + ๊ทผ๊ฑฐ(๋ณธ๋ฌธ์ 200์ ๋ฐ์ท) |
POST /api/ask/stream |
SSE โ conversation/plan/hits/token/tool_start/tool_done/done |
GET /api/stats ยท /api/timeline/{date} ยท /api/digest |
๋์๋ณด๋ ์ง๊ณ (๋ณธ๋ฌธ ์์ด ์ซ์ยท์ฑ ์ด๋ฆ๋ง) |
GET /api/conversations[/{id}] |
๋ํ ๋ชฉ๋ก / ์ฌ์ |
POST /api/slack/send |
์ด์ ์ ์ก โ ์ฌ์ฉ์๊ฐ ๋ฒํผ์ ๋๋ ์ ๋๋ง |
api.py๋ ๋ก์ง์ ์๋ก ์ง์ง ์๋๋ค. ask_auto()๋ฅผ ์๊ฒ ๊ฐ์ธ๊ณ , ์ค๋ ๋ ์ง ๋ค์ด์ ์คํธ๋ง
ํ๋ก์ธ์ค ๋ฉ๋ชจ๋ฆฌ์ 3๋ถ๊ฐ ๋ถ์ก์ ์๋ก๊ณ ์นจ ๋ณ๋ชฉ์ ์์ค๋ค(๋์คํฌ ์บ์์๋ ์ ๋ฃ๋๋ค โ
์ค๋ ๊ธฐ๋ก์ ๊ณ์ ์๊ธฐ๋ฏ๋ก).
flowchart LR
P["git push ยท main"] --> GA["GitHub Actions"]
GA --> IM["docker buildx<br/>โ ghcr.io/โฆ:latest"]
IM --> SSH["ssh EC2"]
SSH --> DC["docker compose pull โ up -d"]
DC --> SVC["screenlog :8000<br/>Basic Auth"]
MB["distribution/mac<br/>๋ฉ๋ด๋ฐ ์ฑ ยท Screenlog.dmg"] --> DL["GET /download"]
SVC --- DL
- ์ปจํ
์ด๋:
uv sync --frozen์ 2๋จ ๋ ์ด์ด(์์กด์ฑ โ ์์ค โ ์ ์ ํ์ผ)๋ก ๋๋ ์บ์๊ฐ ์ ๊นจ์ง๊ฒ. screenpipe sqlite๋:ro๋ก,chroma/๋ ๋ณผ๋ฅจ์ผ๋ก ๋ถ์ธ๋ค. - ๋ฌด๊ฑฐ์ด ์ผ์ ์ ๋ถ ๋ก์ปฌ์์. ์๋ฒ ๋ฉ์ Mac์์ ๋๋ด๊ณ ์๋ฒ๋ก๋ ๊ฒฐ๊ณผ๋ฌผ(๋ฒกํฐ)๋ง ์ฌ๋ฆฐ๋ค. ์๋ณธ ํ๋ ์ DB์ ํ๋ฉด ์บก์ฒ๋ ๋ก์ปฌ์ ๋ ๋์ง ์๋๋ค.
flowchart LR
subgraph MAC["Mac โ ์ฑ ํ๋๋ก ์๊ฒฐ"]
REC["screenpipe ๋
นํ<br/>+ PII ๋ฆฌ๋์
"] --> IX["์ด๋ฒคํธํ โ ์๋ฒ ๋ฉ<br/>BGE-M3 (์ฒซ ์คํ์ ๋ด๋ ค๋ฐ์)"]
end
IX -->|"HTTPS POST /api/ingest<br/>Basic Auth ยท ๋ฒกํฐ๋ง"| APIS
subgraph SRV["EC2"]
APIS["FastAPI"] --> CH["chroma upsert<br/>(์ฌ์์ ๋ถํ์)"]
end
๋ฉ๋ด๋ฐ ์ฑ(distribution/mac/menubar/app.py, rumps)์
๋
นํ ์์/์ค์ง, ์ ์ฅ ์ฉ๋ยท๋ฆฌ๋์
์งํ๋ฅ ํ์, ์๋ฒ ์ค์ , ๋๊ธฐํ๋ฅผ ๋ด๋นํ๋ค.
์ ์ฅ์ ํด๋ก ๋ uv๋ SSH ํค๋ ์์ด .dmg ํ๋๋ก ๋์ํ๋ค. ์ฌ๊ธฐ์์ ํ๋จ๋ค:
-
์ ์ก์ HTTP, ํ์ผ ๋ณต์ฌ๊ฐ ์๋๋ค. ์์ ์
chroma/๋ฅผ ํต์งธ๋กrsyncํ ๋ค ์ปจํ ์ด๋๋ฅผ ์ฌ์์ํ๋๋ฐ, ๊ทธ๋ฌ๋ฉด (1) EC2 ๊ฐ์ธํค๋ฅผ ์ฑ์ ๋ฃ์ด ๋ฐฐํฌํด์ผ ํ๊ณ (2) ๋๋ ํ ๋ฆฌ๋ฅผ ๋ฎ์ด์ฐ๋ ํ์ ๋ ๋ช ์ด ์ฐ๋ฉด ๋์ค ์ฌ๋์ด ์์ฌ๋ ๋ฐ์ดํฐ๋ฅผ ์ง์ฐ๊ณ (3) ์ฌ์์ ๋์ ์๋น์ค๊ฐ ๋ฉ์ถ๋ค. id๊ฐ ๋ด์ฉ ํด์๋ผupsert๋ ์์ฐํ ๋ฉฑ๋ฑํ๋ค. -
์๋ฒ ๋ฉ ์ ์ ์๋ฒ์ ๋จผ์ ๋ฌผ์ด๋ณธ๋ค. ํ์ดํ๋ผ์ธ์์ ์ ์ผ ๋น์ผ ๋จ๊ณ๊ฐ ์๋ฒ ๋ฉ์ด๋ผ,
/api/ingest/known์ผ๋ก ์ด๋ฏธ ์๋ id๋ฅผ ๊ฑธ๋ฌ์ผ ๋ ๋ฒ์งธ ๋๊ธฐํ๋ถํฐ ๋ญ๋น๊ฐ ์๋ค (์ค์ธก: ๋ก์ปฌ ๊ธฐ๋ก์ ์ง์๋ 1.3์ด์ 0๊ฑด์ผ๋ก ๋๋๋ค). -
์๋ฒ๊ฐ ๋ฒกํฐ ์ฐจ์์ ๊ฒ์ฌํ๋ค. ์ฐจ์์ด ๋ค๋ฅธ ๋ฒกํฐ๊ฐ ํ ๋ฒ ์์ด๋ฉด ๊ฒ์์ด ๊นจ์ง๋๋ฐ, ๊ทธ ์์ ์ ์ด๋ ๊ฒ ์๋ชป ๋ค์ด๊ฐ๋์ง ๊ตฌ๋ถํ ์ ์๋ค. ๊ทธ๋์ 422๋ก ๋ฏธ๋ฆฌ ๋ง๋๋ค.
-
๋ชจ๋ธ(2.1GB)์ ๋ฒ๋ค์ด ์๋๋ผ ์ฒซ ์คํ์ ๋ฐ๋๋ค. ๋ฃ์ผ๋ฉด
.dmg๊ฐ 2.8GB๊ฐ ๋์ด ์ ํ ๊ณต์ฆ๋ถํฐ ์ฌ๋ฐฐํฌ๊น์ง ์ ๊ณผ์ ์ด ๋ฌด๊ฑฐ์์ง๋ค โ ๋ด์ฅ ๋ นํ๊ธฐ๊ฐ whisper๋ฅผ ์ฒซ ์คํ์ ๋ฐ๋ ๊ฒ๊ณผ ๊ฐ์ ์ด์ ๋ค. ์ ์ฐ๋onnx/๋ฅผ ์ ์ธํด ๋ฐ๋ ์์ 4.3GB โ 2.1GB๋ก ์ค์๋ค. -
launchd๊ฐ ์๋๋ผ GUI ์ฑ์ด ๋ นํ๊ธฐ๋ฅผ ์ง์ ๋์ด๋ค. launchd๋ก ์กฐ์ฉํ ๋์ฐ๋ฉด macOS ๊ถํ ํ์ ์ ์ฌ์ฉ์๊ฐ ์๋ตํ๊ธฐ ์ ์ ์ฌ์์์ ๋ฐ๋ณตํ๋ค ํฌ๊ธฐํด๋ฒ๋ฆฐ๋ค.
-
GUI ์ฑ์ stdout์
/dev/null๋ก ๊ฐ๋ค. ๊ทธ๋์ ํ์ผ ๋ก๊ทธ๋ฅผ ๋ฐ๋ก ๋จ๊ธฐ๊ณ "๋๊ธฐํ ๋ก๊ทธ ๋ณด๊ธฐ" ๋ฉ๋ด๋ฅผ ๋ถ์๋ค โ ๋ฐฑ๊ทธ๋ผ์ด๋ ์์ ์ด ์กฐ์ฉํ ์คํจํ์ ๋ ์์ธ์ ๋ณผ ์ ์์ด์ผ ํ๋ค. -
๊ณ ์ ํ๋ก์ธ์ค ์ ๋ฆฌ๋ฅผ ์์ ์ ์ ํ๋ค. ์ฑ์ Quitํด๋ ์์ ๋ นํ๊ธฐ๊ฐ ์ด์๋จ์ ํฌํธ๋ฅผ ์ฅ๊ณ ์์ผ๋ฉด, ์๋ก ๋์ด ํ๋ก์ธ์ค๊ฐ ์ฆ์ฌํ๋ฉด์ UI๋ง "๊บผ์ง"์ผ๋ก ์๋ชป ํ์๋๋ค.
๋ฐฐํฌ๋ .dmg ํ๋๋ก ๋ฌถ์ด /download์์ ๋ฐ๊ฒ ํ๋ค. ๋ธ๋ผ์ฐ์ ๋ก ๋ฐ์์ผ ๊ฒฉ๋ฆฌ(quarantine)
์์ฑ์ด ๋ถ์ด์ Gatekeeper ๊ฒฝ๊ณ ๊น์ง ํฌํจํ ์ง์ง ์ต์ด ์ค์น ๊ฒฝํ์ด ์ฌํ ๊ฐ๋ฅํ๋ค.
โ docs/ec2-deployment-guide.md ยท
docs/mac-app-and-download-page.md ยท
docs/mac-app-self-contained.md ยท
์ค์น ์๋ด
ํ๋ฉด ๊ธฐ๋ก์๋ ๋ฉ์ ์ ๋ํ์ ๋ก๊ทธ์ธ ํ๋ฉด์ด ๋ค์ด์๋ค. ์ฒ์๋ถํฐ ์ ์ฝ์ผ๋ก ๋๋ค.
- ์์ง ๋จ๊ณ์์ screenpipe์ PII ๋ฆฌ๋์
(secret/email/phone/person/address, ๋ก์ปฌ ๋ฐฑ์๋)์
์ผ๊ณ , ๋ฆฌ๋์
๋ DB๋ฅผ
mode=ro๋ก๋ง ์ฐ๋ค - ์๋ฒ ๋ฉยท์์ฝ์ ๋ก์ปฌ์์ ๋๋ด๊ณ ๊ฒฐ๊ณผ๋ฌผ(
chroma/)๋ง ๋ณด๋ธ๋ค โ ์๋ณธ ํ๋ ์ DB๋ ๋ก์ปฌ์ ๋ ๋์ง ์๋๋ค chroma/,.env,eval/*/runs/๋ ์ปค๋ฐ๋์ง ์๋๋ค- API๊ฐ ๋ด๋ณด๋ด๋ ๊ทผ๊ฑฐ๋ ๋ณธ๋ฌธ ์ ์ฒด๊ฐ ์๋๋ผ 200์ ๋ฐ์ท๋ง ๋ณด์ด๊ฒ ํ๋ค.
- ๋์๋ณด๋ ์ง๊ณ๋ ๋ณธ๋ฌธ์ ์์ ์ ์ฝ๋๋ค โ ์ซ์์ ์ฑ ์ด๋ฆ๋ง
- ํค๊ฐ ์์ผ๋ฉด ์๋ฒ๊ฐ ๊ธฐ๋์ ๊ฑฐ๋ถํ๊ณ , ๋น๊ต๋
secrets.compare_digest
๋จ์ ๊ฒ๊ณผ ํด๊ฒฐ ๋ฐฉ์์ ๊ฐ์ด ์ ์๋ค.
| ํ๊ณ | ์ด๋ ๊ณ์ธต์ ๋ฌธ์ ์ธ๊ฐ | ํด๊ฒฐ ๋ฐฉ์ |
|---|---|---|
| Discord ์บก์ฒ๊ฐ ์ค์ ๋ฉ์์ง๊ฐ ์๋ ์ฌ์ด๋๋ฐ(์๋ฒยท์ฑ๋ ๋ชฉ๋ก) ์์ฃผ๋ก ์ฐํ | ์์ง/OCR โ ์ฒญํนยท๊ฒ์์ผ๋ก ๋ชป ๊ณ ์นจ | ํ๋ ์์ ์ด๋ฏธ ์ ์ฅ ์ค์ธ text_source(AX ํธ๋ฆฌ / OCR ํด๋ฐฑ)๋ฅผ ํ์ฉํด AX์ผ ๋ ์ฑํ
์์ญ ๋
ธ๋๋ง ์ทจํ๋๋ก ์์ง์ ์ขํ๋ค. ๊ทธ ์ ์ ์ ์ญ ๋น๋ฐ ๋ผ์ธ ์ ๊ฑฐ๋ฅผ clean.py์ ์น์ด ๋น์ฉ ์์ด ํจ๊ณผ๋ฅผ ๋จผ์ ์ฐ๋ค |
| ์ฐฝ์ด ๊ฒน์ณ ์ฐํ๋ฉด ๋ณธ๋ฌธ์ด ์์ (GmailยทZoom์์ ํ์ธ) | ์์ง | ํ์ฑ ์ฐฝ ๊ธฐ์ค์ผ๋ก๋ง ํ ์คํธ๋ฅผ ์ทจํ๋๋ก ํํฐ๋ง. ๋จผ์ ๊ฒน์นจ ๋ฐ์๋ฅ ์งํ๋ฅผ ๋ง๋ค์ด ๋น๋๋ฅผ ์ฌ๋ ๊ฒ ์์ |
| Jiraยท์บ๋ฆฐ๋ ์ฐฝ์ ์ฒญํน ๋ฏผ๊ฐ๋ ๋ฏธ๊ฒ์ฆ | ํ๊ฐ ์ปค๋ฒ๋ฆฌ์ง | ์ด๋ฏธ ์ถ์ถํด๋ "์ฒญํน์ ๋ฏผ๊ฐํ ์ฐฝ 48๊ฐ" ๋ชฉ๋ก์์ ๊ณจ๋ ์ ๋ฌธํญ์ ๋ณด๊ฐํด ์ฌ์ธก์ |
| ๊ณจ๋ ์ r11 ๋ผ๋ฒจ ์ ๋ขฐ๋ ๋ฎ์ (์ฐฝ ์ ๋ชฉ์ด ๋ฌด์๋ฏธํ ํ๋ฉด) | ๋ผ๋ฒจ๋ง ๋๊ตฌ | ์ฐฝ ์ ๋ชฉ์ด ์๋๋ผ ๋ณธ๋ฌธ ์๋ฒ ๋ฉ ํด๋ฌ์คํฐ๋ก ํ๋ณด๋ฅผ ๋ฌถ์ด ๋ณด์ฌ์ฃผ๋๋ก ๋๊ตฌ ๊ฐ์ |
| ๋น๊ตํยท์ง๊ณํ์ ์ ํ๋ ๋ฏธ๊ฒ์ฆ ("ํฌ๋์ ์ ๋จ"๊น์ง๋ง ํ์ธ) | ํ๊ฐ | ์ง๊ณ๋ metadata์์ ์ ๋ต์ ์ฝ๋๋ก ์ฐ์ถํ ์ ์๋ค โ ์๋ ์ ๋ต ๋ผ๋ฒจ ์์ฑ์ผ๋ก ์์ ์๋ ์ฑ์ |
SCREENPIPE_DB๊ฐ ์ต๊ทผ ๋ฉฐ์น ์น๋ง ๋ณด์กด โ ๊ณผ๊ฑฐ ์ฌ์คํ์ด ์์ฃผ ๋งํ |
๋ฐ์ดํฐ ๋ณด์กด ์ ์ฑ | ์ฌ์คํ์ด ํ์ํ ๊ธฐ๊ฐ๋ง ๋ณ๋ ๋ฐฑ์ ํ๋ ์ ์ฐจ๋ฅผ ๋ง๋ ๋ค |
๋ก์ปฌ LLM recency bias ํด๋ฒ(LoRA/ํ๋กฌํํธ ๋ถํ ) ๋ ๋ค ๊ฒ์ฆ๋ง ํ๊ณ summarize.py์ ๋ฏธ๋ฐ์ |
์ค์ฌ์ฉ ์ฐ๊ฒฐ | ๋ ์ค ํ๋๋ฅผ USE_LOCAL_LLM ๊ฒฝ๋ก์ ์ค์ ๋ก ์ฐ๊ฒฐ โ LoRA๋ GGUF๋ง ๊ต์ฒด, ๋ถํ ์ summarize_day()์ map-reduce ์ถ๊ฐ |
๋ค์ ๋ง์ผ์คํค โ "๋ฌผ์ด๋ด์ผ ๋ตํ๋ ๋๊ตฌ"์์ "๋จผ์ ์ ๋ฆฌํด์ฃผ๋ ํ๋ก๋ํธ"๋ก
์๊ฐ ๊ฐ์์ผ ํ ๋ถ์ฑ๋ผ๋ฉด, ์ฌ๊ธฐ๋ ์ด ๋๊ตฌ๊ฐ ์ด๋๋ก ๊ฐ์ผ ํ๋๊ฐ๋ค. ์ ๋ค ์ด๋ฏธ ๋ง๋ค์ด๋ ์กฐ๊ฐ์ ์๋ ์ผ์ด๋ผ ์ ๊ธฐ์ ์ด ์๋๋ผ ์ ํ ํ๋จ์ ๋ฌธ์ ๋ค.
| ๋ฐฉํฅ | ์ด๋ฏธ ์๋ ์กฐ๊ฐ | ๋ค์ ๋จ๊ณ |
|---|---|---|
| ์ฃผ๊ฐ ์ ๋ฌด ๋ฆฌํฌํธ ์๋ ์ด์ | ํ๋ฃจ ์์ฝ ์บ์ + summarize_range() + ์ธ์์ธ๊ณ/์ฌ๋ ์ด์ ์์ |
๊ธ์์ผ ์ ๋ ์ ๊ทธ ์ฃผ์ ์บ์๋ฅผ ๋ชจ์ ๋ฆฌํฌํธ ์ด์์ ๋จผ์ ๋ง๋ค์ด ๋๊ณ ์๋ฆผ๋ง ์ค๋ค. ์ฌ๋์ ๊ณ ์น๊ณ ์น์ธ๋ง โ "์ด๋ฒ ์ฃผ ๋ญ ํ์ง"๋ฅผ ๋งค๋ฒ ๋ฌป์ง ์์๋ ๋๊ฒ |
| ๋ฌป๊ธฐ ์ ์ ๋จผ์ ๋งํด์ฃผ๊ธฐ | /api/digest(์ต๊ทผ n์ผ ์์ฝ) + ํ๋ ์๋ยท๋ฆฌ๋ณธ ํ์๋ผ์ธ |
ํ๋ฃจ ๋ง๊ฐ ๋ค์ด์ ์คํธ, "์ด์ ์ ๋ค๋ฅธ ์ "์ฒ๋ผ ๋ณํ๋ฅผ ๊ฐ์งํด์ ๋จผ์ ๋์ฐ๋ ์๋ฆผ. |
| ํ์์ ์ฐ๋ ๋ฐ์ดํฐ๋ ๊ฐ์ ๋ก์ปฌ์ | .dmg ๋ฐฐํฌ + /download + Basic Auth + chroma/๋ง ์ ์กํ๋ ๋๊ธฐํ |
๊ณ์ ๋ณ ์ธ๋ฑ์ค ๊ฒฉ๋ฆฌ์ ๊ถํ. ์๋ณธ์ ๊ฐ์ ๊ธฐ๊ธฐ์ ๋๊ณ ์์ฝ๋ณธ๋ง ๊ณต์ ํ๋ ๊ฒฝ๊ณ๋ฅผ ์ ์งํ๋ ๊ฒ ์ค๊ณ์ ํต์ฌ. |
์ธ ๋ฐฉํฅ ๋ชจ๋ "์ฌ์ฉ์๊ฐ ์ง๋ฌธ์ ๋ ์ฌ๋ ค์ผ ํ๋ค"๋ ์ง๊ธ์ ์ ์ ๋ฅผ ๊นจ๋ ๊ฒ์ด ๋ชฉํ๋ค.
| ๋ฌธ์ | ๋ด์ฉ |
|---|---|
| ์ค๊ณ ๊ฒฐ์ ๊ธฐ๋ก | ์ ๊ทธ๋ ๊ฒ ์ ํ๋ โ ์์ ์์น 4๊ฐ์ง, ๊ฐ๋ฐ ๋จ๊ณ๋ณ ํต๊ณผ ๊ธฐ์ค, ์ค์ธก์ผ๋ก ์ ํ ๊ฐ๋ค, ๋ฐฐํฌ, API |
docs/troubleshooting-star.md |
STAR ํ์ 23๊ฑด โ 4๊ฒน์ผ๋ก ์์ธ ์ฑ๋ฅ ์ ํ, ์กฐ์ฉํ ์คํจํ๋ ํด๋ฐฑ, ๊ฒ์ดํธ์จ์ด ํ๋ ๋๋ฝ, ์ฝ๋ ๋ฆฌ๋ทฐ๋ก ๋ฐ๊ฒฌํ ๋ ์ด์ค ๋ฑ |
eval/retrieval/RETRIEVAL_REPORT.md |
๊ณจ๋ ์ ๊ตฌ์ถ ยท recall@k ยท ์ฒญํน ์ค์ ยท ๊ฒ์ ์ ๋ต 7์ข ยท ์๋ฒ ๋ฉ ๋ชจ๋ธ 3์ข |
eval/routing/REPORT.md |
๋ฐ๋๋ผ โ ๋ฉํ ํํฐ โ ๋ผ์ฐํ โ ์ฌ๋ฌ ๋ ์ง, ๋จ๊ณ๋ณ ๋น๊ต |
docs/routing-verification.md |
๋ผ์ฐํ 12์ผ์ด์ค ์๋ ๊ฒ์ฆํ |
docs/local-llm-experiment-report.md |
๋ก์ปฌ LLM 3์ข ๋น๊ต โ recency bias ์์ธ ๋ถ์ โ LoRAยทํ๋กฌํํธ ๋ถํ ๋ ํด๋ฒ ๊ฒ์ฆ (์ง๋ฌธ๋ณ ์๋ฌธ ๋ต๋ณ ์ ๋ถ ํฌํจ) |
docs/langgraph-architecture.md |
2๋จ ๊ทธ๋ํ ๊ตฌ์กฐ (์ปดํ์ผ๋ ๊ทธ๋ํ์์ ๋ฝ์ mermaid) + ๋ ธ๋๋ณ state ํ |
docs/streaming-and-async.md |
SSEยทasync ์ ํ โ ์ด๋์ ์ด๋์ด ๋๊ณ ์ด๋์ ์ ๋๋์ง, ๋๋๋ฆฐ ๋ณ๊ฒฝ๊น์ง |
docs/summary-cache.md |
ํ๋ฃจ ์์ฝ ์บ์์ ์ผ๋ถ๋ฌ ์ฐํํ๋ 6๊ฐ์ง ์กฐ๊ฑด |
docs/ec2-deployment-guide.md |
๋ฐฐํฌ ํ์ดํ๋ผ์ธ ์ ์ ์ฐจ + ๊ฒช์ ๋ฌธ์ 6๊ฑด |
docs/mac-app-and-download-page.md |
screenpipe ์์ค ๋น๋ ยท py2app ํจํค์ง ยท Gatekeeper ยท ๋ค์ด๋ก๋ ํ์ด์ง |
docs/mac-app-self-contained.md |
์ฑ ์๋ฆฝํ โ HTTP ์ธ์ ์คํธ ์ ํ ยท ๋ชจ๋ธ ์ฒซ ์คํ ๋ค์ด๋ก๋ ยท ์ ์ฅ์/SSH ํค ์์กด ์ ๊ฑฐ |
์ค์น ยท ์์ธ ยท ์คํ ยท ํ๊ฐ โ ๋ช ๋ น์ด ํผ์น๊ธฐ
์๊ตฌ์ฌํญ โ Python 3.14 ยท uv ยท macOS(์๋ฒ ๋ฉ MPS ๊ฐ์) ยท
screenpipe๋ก ์์ง๋ db.sqlite
uv sync && cp .env.example .env.env์ ์ต์ํ ์ด ์
์ ์ฑ์ด๋ค. ์์ผ๋ฉด ์๋ฒ๊ฐ ๊ธฐ๋ํ์ง ์๋๋ค(ํ๋ฉด ๊ธฐ๋ก์ ๋ค๋ฃจ๋ API๋ผ
์ธ์ฆ ์์ด ๋จ๋ ๊ฒ์ config.py๊ฐ ๋ง๋๋ค).
OPENAI_API_KEY=... # ๋๋ ANTHROPIC_API_KEY / USE_LOCAL_LLM=1
SCREENLOG_USER=...
SCREENLOG_PASSWORD=...
์์ธ โ ์ด๋ค ๋ ์ง๊ฐ ์๋์ง ๋ณด๊ณ , ์ ์ ๊ฒฐ๊ณผ๋ฅผ ๋์ผ๋ก ํ์ธํ ๋ค, ํ๋ฃจ์ฉ ๋ฃ๋๋ค.
uv run python -m screenlog.source # ์์ง๋ ๋ ์ง ๋ชฉ๋กuv run python -m screenlog.clean 2026-08-05 # ์ ์ ๊ฒฐ๊ณผ ๋ฌด์์ 3๊ฑด ํ์ธuv run python -m screenlog.index 2026-08-05 # ๋ ์ง ์๋ต ์ ๋ฏธ์์ธ๋ถ ์ ๋ถuv run python -m screenlog.summarize # ์ง๋ ๋ ํ๋ฃจ ์์ฝ ์บ์ ์ฑ์ฐ๊ธฐ์คํ
uv run python -m screenlog.ask # CLI โ ๋ต๋ณ + ๊ทผ๊ฑฐ ๋ชฉ๋กuv run uvicorn screenlog.api:app --reload # http://localhost:8000docker compose up --build # ์ปจํ
์ด๋๋กํ๊ฐ
uv run python eval/routing/run_eval.py --auto # ์ค์ ์ง์
์ ์ผ๋ก 18๋ฌธํญuv run python eval/retrieval/eval_retrieval.py # ๊ณจ๋ ์
recall@kuv sync --extra bm25 && uv run python eval/retrieval/final_search_comparison.pyLLM ๋ฐฑ์๋ ์ฐ์ ์์๋
USE_LOCAL_LLMโOPENAI_API_KEYโANTHROPIC_API_KEY. ๋ก์ปฌ LLM์ผ๋ก ์ผฐ๋ค๊ฐ ๋ง์ฝ์ด๋ฉด ํ๊ฒฝ๋ณ์ ํ ์ค๋ง ๋น์ฐ๋ฉด ์ฝ๋ ๋ณ๊ฒฝ ์์ด ๋กค๋ฐฑ๋๋ค.
ํ๋ก์ ํธ ๊ตฌ์กฐ
src/screenlog/ # ๋ณธ์ฒด
โโโ config.py # ์คํํ๋ฉด์ ๋ฐ๋๋ ๊ฐ ์ ๋ถ ์ฌ๊ธฐ (๊ทผ๊ฑฐ ์ฃผ์ ํฌํจ)
โโโ source.py # 1. screenpipe sqlite โ ํ๋ ์ (์ฝ๊ธฐ ์ ์ฉ, UTCโKST)
โโโ clean.py # 2. ํ๋ ์ โ ์ด๋ฒคํธ (๋ฌถ๊ธฐยท์ค์ด๊ธฐยท๋๋๊ธฐ, URLโ๋๋ฉ์ธ)
โโโ index.py # 3. BGE-M3 ์๋ฒ ๋ฉ โ chroma (์ฒดํฌํฌ์ธํธยท๋ฐฑํยท๋ฝ)
โโโ router.py # 3. route() โ ์ง๋ฌธ โ app/site/hour/periods/intent/compound
โโโ ask.py # 4. search() + ask() + ask_auto() + ํ ํฐ ์คํธ๋ฆฌ๋ฐ
โโโ summarize.py # 4. ์ ๋ฆฌ/๋น๊ต/์ง๊ณ + ์ธ์์ธ๊ณ/์ฌ๋ ์ด์ + ์บ์ ํ๋ฆฌ๋น๋
โโโ summary_cache.py # ํ๋ฃจ ์์ฝ ์บ์ (sqlite, model ํค ํฌํจ)
โโโ chat_history.py # ๋ํ ๊ธฐ๋ก (sqlite, ์ ๋ชฉ์ ์ฒซ ์ง๋ฌธ์ ๊ทธ๋๋ก ์๋ฆ)
โโโ stats.py # ๋์๋ณด๋ ์ง๊ณ โ metadata๋ง, ๋ณธ๋ฌธ์ ์ ์ฝ์
โโโ slack_client.py # chat.postMessage ํ๋๋ง ๊ฐ์ผ ์ ์์ค ํธ์ถ
โโโ api.py # 6. FastAPI โ SSE ยท Basic Auth ยท ์ ์ ์๋น
โโโ static/ # index(๋๋ฉ) ยท dashboard(๋ฌผ์ด๋ณด๊ธฐ) ยท explore(ํ์) ยท tokens.css
src/screenlog_langgraph/ # ์ค์ผ์คํธ๋ ์ด์
๋ง LangGraph๋ก
โโโ graph.py # route โ search/single_period/multi_period/fallback
โโโ agent.py # compound๋ฉด ReAct ๋ฃจํ (๋๊ตฌ 6๊ฐ, recursion_limit=8)
src/screenlog_langchain/ # LLM ํธ์ถ๋ง LCEL๋ก (๋น๊ต์ฉ) โ chains/router/pipeline
eval/routing/ # ๋ผ์ฐํ
ํ๊ฐ โ questions.jsonl ยท run_eval.py ยท eval_routing.py ยท REPORT.md
eval/retrieval/ # ๊ฒ์ ํ๊ฐ โ ๊ณจ๋ ์
25๋ฌธํญ ยท ๋ผ๋ฒจ๋ง ๋๊ตฌ ยท ์ฒญํน/k/์ ๋ต/์๋ฒ ๋ฉ ์ค์ ยท RETRIEVAL_REPORT.md
eval/summary_chunking/ # ์๊ฐ๋ ๋ถํ ์์ฝ(map-reduce) ์คํ 4์ข
โ ๋ถํ / ํ์์ํฅ / reduce / ์ค์ผ๋ธ๋ก ์ฌ์๋
eval/lora/ # LoRA ํ์ต ๋ฐ์ดํฐ ์์ฑ ยท ์์ํ ๋ชจ๋ธ held-out ๋น๊ต
docs/ # ํธ๋ฌ๋ธ์ํ
(STAR) 23๊ฑด + ์ฃผ์ ๋ณ ๊ธฐ๋ก 8ํธ
distribution/mac/ # ๋ฉ๋ด๋ฐ ์ฑ(rumps) ยท Screenlog.dmg ยท ๋ค์ด๋ก๋ ํ์ด์ง ยท ์ค์น ์๋ด
.github/workflows/ # deploy.yml โ ๋น๋ โ GHCR โ SSH ์ฌ๋ฐฐํฌ
Dockerfile, docker-compose*.yml, pyproject.toml, uv.lock










