freshcrate
Home > AI Agents > MOP

MOP

A local LLM-based autonomous agent orchestration platform featuring async background tasks, context-isolated sub-agents, dynamic knowledge injection, and strict security approval gates (Plan Mode).

Description

A local LLM-based autonomous agent orchestration platform featuring async background tasks, context-isolated sub-agents, dynamic knowledge injection, and strict security approval gates (Plan Mode).

README

๐Ÿค– MOP (Main Operating Process) : ์ž์œจ ์ง„ํ™”ํ˜• ๋กœ์ปฌ AI ์—์ด์ „ํŠธ

MOP๋Š” ์™„์ „ํ•œ ๋กœ์ปฌ ํ™˜๊ฒฝ(Local Environment)์—์„œ ๊ตฌ๋™๋˜๋ฉฐ, ์Šค์Šค๋กœ ์ฝ”๋“œ๋ฅผ ์ž‘์„ฑํ•˜๊ณ  ์‹œ์Šคํ…œ์„ ์ œ์–ดํ•˜๋ฉฐ ์žฅ๊ธฐ ๊ธฐ์–ต์„ ๋ฐ”ํƒ•์œผ๋กœ ์ž์œจ์ ์œผ๋กœ ์„ฑ์žฅํ•˜๋Š” ์ง€๋Šฅํ˜• ๋ฐ์Šคํฌํ†ฑ AI ์—์ด์ „ํŠธ์ž…๋‹ˆ๋‹ค.

๋‹จ์ˆœํ•œ ์ฑ—๋ด‡์„ ๋„˜์–ด, ์‚ฌ์šฉ์ž์˜ ๊ฐœ์ž… ์—†์ด๋„ ๋ฐฑ๊ทธ๋ผ์šด๋“œ์—์„œ ์Šค์Šค๋กœ ๋„๊ตฌ๋ฅผ ๋งŒ๋“ค๊ณ  ๊ฒ€์ฆ(TDD)ํ•˜๋ฉฐ, ๊ฐ€์ƒํ™˜๊ฒฝ(venv) ๋‚ด์—์„œ ์•ˆ์ „ํ•˜๊ฒŒ OS ๋ช…๋ น์–ด์™€ ํŒŒ์ด์ฌ ์Šคํฌ๋ฆฝํŠธ๋ฅผ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.


โœจ ํ•ต์‹ฌ ๊ธฐ๋Šฅ (Key Features)

๐Ÿง  1. ๋กœ์ปฌ LLM & ์ง€๋Šฅํ˜• ๋ฉ”๋ชจ๋ฆฌ ๊ด€๋ฆฌ

  • ๋กœ์ปฌ ๋ชจ๋ธ ๊ตฌ๋™: llama-cpp-python ๊ธฐ๋ฐ˜์œผ๋กœ ์™ธ๋ถ€ API ์ข…์† ์—†์ด GGUF ๋ชจ๋ธ์„ ์™„๋ฒฝํ•˜๊ฒŒ ๋กœ์ปฌ์—์„œ ๊ตฌ๋™ํ•ฉ๋‹ˆ๋‹ค.
  • KV ์บ์‹œ ์–‘์žํ™”(Quantization): FP16, Q8_0, Q4_0 ๋“ฑ ์ปจํ…์ŠคํŠธ ๋ฉ”๋ชจ๋ฆฌ ์••์ถ• ๊ธฐ์ˆ ์„ ์ ์šฉํ•˜์—ฌ ๋ฌดํ•œํžˆ ๊ธธ์–ด์ง€๋Š” ๋Œ€ํ™”์—์„œ๋„ VRAM์„ ๊ทน๋„๋กœ ์ ˆ์•ฝํ•ฉ๋‹ˆ๋‹ค.
  • ์žฅ๊ธฐ ๊ธฐ์–ต(Vector DB): ๋Œ€ํ™” ๋‚ด์šฉ ์ค‘ ์ค‘์š”ํ•œ ์—๋Ÿฌ ํ•ด๊ฒฐ์ฑ…, ์‚ฌ์šฉ์ž์˜ ์ทจํ–ฅ ๋“ฑ์„ Vector DB์— ์˜๊ตฌ ์ €์žฅํ•˜๊ณ , ์˜๋ฏธ ๊ธฐ๋ฐ˜(Semantic)์œผ๋กœ ๊ฒ€์ƒ‰ํ•˜์—ฌ ํ™œ์šฉํ•ฉ๋‹ˆ๋‹ค.

โš™๏ธ 2. ์ž์œจ ์„ฑ์žฅ & TDD (ํ…Œ์ŠคํŠธ ์ฃผ๋„ ๊ฐœ๋ฐœ) ๋ฃจํ”„

  • ์ž์œจ ์„ฑ์žฅ ๋ชจ๋“œ (Idle Mode): ์‚ฌ์šฉ์ž๊ฐ€ ์ž๋ฆฌ๋ฅผ ๋น„์šฐ๋ฉด AI๊ฐ€ ์Šค์Šค๋กœ ์ž‘๋™ํ•˜์—ฌ ์ฝ”๋“œ๋ฅผ ์ž‘์„ฑํ•˜๊ณ  ์‹œ์Šคํ…œ์„ ์ตœ์ ํ™”ํ•ฉ๋‹ˆ๋‹ค.
  • ๋™์  ๋„๊ตฌ ์ƒ์„ฑ (create_new_tool): AI๊ฐ€ ์Šค์Šค๋กœ ํŒŒ์ด์ฌ ๋„๊ตฌ(Tool)๋ฅผ ์ž‘์„ฑํ•˜๊ณ  res/custom_tools.json์— ์˜๊ตฌ ๋“ฑ๋กํ•˜์—ฌ ๋‹ค์Œ ํ„ด๋ถ€ํ„ฐ ์ฆ‰์‹œ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
  • ๊ฐ•์ œ 2๋‹จ๊ณ„ ์ปดํŒŒ์ผ ๊ฒ€์ฆ: ํŒŒ์ผ ์ˆ˜์ •(edit_file, append_to_file) ๋ฐ ์ƒˆ ๋„๊ตฌ ์ƒ์„ฑ ์‹œ, ์‹คํ–‰ ์ „ ๋ฐ˜๋“œ์‹œ python -m py_compile์„ ํ†ตํ•ด ๋ฌธ๋ฒ• ์—๋Ÿฌ(Syntax Error)๋ฅผ ์‚ฌ์ „ ์ฐจ๋‹จํ•ฉ๋‹ˆ๋‹ค.

๐Ÿ›ก๏ธ 3. ๋ฌด์ ์˜ ์‹œ์Šคํ…œ ๋ฐฉ์–ด๋ง‰ (Safety & Shielding)

  • Venv Lock (๊ฐ€์ƒํ™˜๊ฒฝ ๋‚ฉ์น˜): AI๊ฐ€ ์‰˜ ๋ช…๋ น์–ด์—์„œ python์ด๋‚˜ pip๋ฅผ ํ˜ธ์ถœํ•  ๊ฒฝ์šฐ, ์ •๊ทœ์‹์„ ํ†ตํ•ด ์‹œ์Šคํ…œ ํŒŒ์ด์ฌ์ด ์•„๋‹Œ sys.executable (ํ˜„์žฌ ๊ฐ€์ƒํ™˜๊ฒฝ)๋กœ ๊ฐ•์ œ ๋งคํ•‘ํ•˜์—ฌ ์˜์กด์„ฑ ์ถฉ๋Œ์„ ๋ง‰์Šต๋‹ˆ๋‹ค.
  • ์ฝ”์–ด ํŒจํ‚ค์ง€ ๋ณดํ˜ธ: AI๊ฐ€ ์ž์œจ ๋ชจ๋“œ ์ค‘ llama-cpp-python, torch ๋“ฑ ์‹œ์Šคํ…œ์˜ ํ•ต์‹ฌ ๋‡Œ๋ฅผ ๊ฑด๋“œ๋ฆฌ๋Š” ํŒจํ‚ค์ง€๋ฅผ ๋ฎ์–ด์”Œ์šฐ๋ ค(์—…๋ฐ์ดํŠธ) ํ•  ๊ฒฝ์šฐ, ์‰˜ ๋„๋‹ฌ ์ „์— ์ฆ‰์‹œ ์ฐจ๋‹จํ•ฉ๋‹ˆ๋‹ค.
  • ์œˆ๋„์šฐ CMD ๋ฒ„๊ทธ ๋ฐฉ์–ด: ๊ฒฝ๋กœ์— ๋„์–ด์“ฐ๊ธฐ๊ฐ€ ์žˆ์„ ๋•Œ ์œˆ๋„์šฐ์˜ ๋”ฐ์˜ดํ‘œ(") ์ฆ๋ฐœ ๋ฒ„๊ทธ๋ฅผ ๋ง‰๊ธฐ ์œ„ํ•ด ๋ช…๋ น์–ด๋ฅผ ์•ˆ์ „ํ•˜๊ฒŒ ์ด์ค‘ ๋ž˜ํ•‘(Wrapping)ํ•ฉ๋‹ˆ๋‹ค.
  • ์Šค๋ ˆ๋“œ ์•ˆ์ „์„ฑ(Thread-Safety): ์ž์œจ ๋ชจ๋“œ๋‚˜ ์ˆ˜๋ฉด ๋ชจ๋“œ ๊ตฌ๋™ ์ค‘ ์‚ฌ์šฉ์ž์˜ ์ฑ„ํŒ… ์ž…๋ ฅ์„ ๋ฌผ๋ฆฌ์ /์‹œ๊ฐ์ ์œผ๋กœ ์ฐจ๋‹จ(Disable)ํ•˜์—ฌ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค ๋ฐ ์—”์ง„ ์ถฉ๋Œ์„ ์›์ฒœ ๋ด‰์‡„ํ•ฉ๋‹ˆ๋‹ค.

๐ŸŽจ 4. ์ง๊ด€์ ์ด๊ณ  ์„ธ๋ จ๋œ UI (CustomTkinter)

  • ์‚ฌ๊ณ  ๊ณผ์ • ๋ถ„๋ฆฌ (Toggle UI): AI์˜ ๋ณต์žกํ•œ ์ถ”๋ก  ๊ณผ์ •(<think> ๋ธ”๋ก)์„ ๋‚ด๋ถ€์ ์œผ๋กœ ํŒŒ์‹ฑํ•˜์—ฌ, UI ์ƒ์—์„œ๋Š” ๊น”๋”ํ•œ ์ ‘๊ธฐ/ํŽด๊ธฐ(Toggle) ๋ฒ„ํŠผ์œผ๋กœ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
  • ์ง€๋Šฅํ˜• JSON ํŒŒ์‹ฑ: AI๊ฐ€ ์ถœ๋ ฅ ๋„์ค‘ ๊ด„ํ˜ธ๋ฅผ ๋ˆ„๋ฝํ•˜๋”๋ผ๋„ ์Šค์Šค๋กœ ์—ด๊ณ  ๋‹ซํžŒ ๊ด„ํ˜ธ๋ฅผ ๊ณ„์‚ฐํ•˜์—ฌ ๋ณต๊ตฌํ•˜๋Š” ์•ˆ์ „์žฅ์น˜๊ฐ€ ์ ์šฉ๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค.
  • ์ˆ˜๋ฉด/์ตœ์ ํ™” ์ƒํƒœ UI: ์‹œ์Šคํ…œ์˜ ์ƒํƒœ(๋Œ€๊ธฐ, ์ž‘์—… ์ค‘, ์ˆ˜๋ฉด ์ค‘)๋ฅผ ์‹ค์‹œ๊ฐ„์œผ๋กœ ๋ชจ๋‹ˆํ„ฐ๋งํ•˜์—ฌ ๋ฒ„ํŠผ ์ƒํƒœ์™€ ํ…์ŠคํŠธ๋กœ ์‚ฌ์šฉ์ž์—๊ฒŒ ๋ช…ํ™•ํžˆ ํ”ผ๋“œ๋ฐฑํ•ฉ๋‹ˆ๋‹ค.

๐Ÿ› ๏ธ ๊ธฐ์ˆ  ์Šคํƒ (Tech Stack)

  • Language: Python 3.10+
  • AI Backend: llama-cpp-python
  • UI Framework: CustomTkinter
  • Memory: SQLite (Short-term), Vector DB (Long-term / Semantic Search)
  • OS Support: Windows (์ตœ์ ํ™”)

๐Ÿš€ ์ฃผ์š” ๋ชจ๋“œ ์„ค๋ช…

๐ŸŒ™ ์ˆ˜๋ฉด ๋ชจ๋“œ (Deep Sleep Consolidation)

์‚ฌ์šฉ์ž๊ฐ€ ๋‡Œ ์ตœ์ ํ™” ๋ฐ ์ˆ˜๋ฉด ๋ฒ„ํŠผ์„ ๋ˆ„๋ฅด๋ฉด ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค.

  1. ๋‹จ๊ธฐ ๊ธฐ์–ต(chat_history.db)์„ ์š”์•ฝ ๋ฐ ๋น„์›Œ๋‚ด์–ด ์ปจํ…์ŠคํŠธ ๊ณผ๋ถ€ํ•˜๋ฅผ ๋ฐฉ์ง€ํ•ฉ๋‹ˆ๋‹ค.
  2. ์ด์ „ ๋Œ€ํ™” ์ค‘ ์˜๊ตฌ ๋ณด์กดํ•  ๊ฐ€์น˜๊ฐ€ ์žˆ๋Š” ํ•ต์‹ฌ ๊ธฐ์–ต์„ ์ถ”์ถœํ•˜์—ฌ Vector DB์— ์ด๊ด€ํ•ฉ๋‹ˆ๋‹ค.
  3. ์ˆ˜๋ฉด ์ค‘์—๋Š” ์ž์œจ ์„ฑ์žฅ ๋ฃจํ‹ด์ด๋‚˜ ์‚ฌ์šฉ์ž์˜ ์ฑ„ํŒ… ์ž…๋ ฅ์„ ์ฐจ๋‹จํ•˜์—ฌ ๋ฐ์ดํ„ฐ ๋ฌด๊ฒฐ์„ฑ์„ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค.

๐ŸŒฑ ์ž์œจ ์„ฑ์žฅ ๋ชจ๋“œ (Autonomous Growth)

์ผ์ • ์‹œ๊ฐ„ ์‚ฌ์šฉ์ž์˜ ์ž…๋ ฅ์ด ์—†์œผ๋ฉด ๋ชจ๋‹ˆํ„ฐ๋ง ๋ฃจํ”„๊ฐ€ ์ด๋ฅผ ๊ฐ์ง€ํ•˜์—ฌ ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค.

  1. ์Šค์Šค๋กœ ํ™˜๊ฒฝ์„ ํŒŒ์•…ํ•˜๊ณ , ๋ฐฑ๊ทธ๋ผ์šด๋“œ ์‰˜์„ ํ†ตํ•ด ์ฝ”๋“œ๋ฅผ ์ž‘์„ฑ ๋ฐ ํ…Œ์ŠคํŠธํ•ฉ๋‹ˆ๋‹ค.
  2. ๋‹ค์ค‘ ์ž‘์—…์ด ํ•„์š”ํ•  ๊ฒฝ์šฐ ํ•˜์œ„ ์—์ด์ „ํŠธ์—๊ฒŒ ๋ณ‘๋ ฌ๋กœ ์œ„์ž„(delegate_parallel_task)ํ•˜๊ณ  ๊ฒฐ๊ณผ๋ฅผ ์ทจํ•ฉํ•ฉ๋‹ˆ๋‹ค.

โš ๏ธ ์ฃผ์˜ ์‚ฌํ•ญ (Disclaimer)

  • ๋ณธ ์—์ด์ „ํŠธ๋Š” ๋กœ์ปฌ ์‹œ์Šคํ…œ์˜ ํŒŒ์ผ ์ฝ๊ธฐ/์“ฐ๊ธฐ ๋ฐ ์‰˜ ๋ช…๋ น์–ด ์‹คํ–‰ ๊ถŒํ•œ์„ ๊ฐ€์ง€๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค. ํ”„๋กœ์ ํŠธ ํด๋” ์™ธ๋ถ€์˜ ์ค‘์š”ํ•œ ์‹œ์Šคํ…œ ํŒŒ์ผ์„ ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š๋„๋ก ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ(์ง€์นจ)๋ฅผ ์œ ์ง€ํ•ด ์ฃผ์„ธ์š”.
  • ๊ฐ€์ƒํ™˜๊ฒฝ(venv) ๋‚ด์—์„œ ์‹คํ–‰ํ•˜๋Š” ๊ฒƒ์„ ๊ฐ•๋ ฅํžˆ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค.

Release History

VersionChangesUrgencyDate
0.0.0No release found โ€” using repo HEADHigh4/9/2026
main@2026-04-09Latest activity on main branchHigh4/9/2026
main@2026-04-09Latest activity on main branchHigh4/9/2026
main@2026-04-09Latest activity on main branchHigh4/9/2026
main@2026-04-09Latest activity on main branchHigh4/9/2026
main@2026-04-09Latest activity on main branchHigh4/9/2026
main@2026-04-09Latest activity on main branchMedium4/9/2026
main@2026-04-09Latest activity on main branchMedium4/9/2026
main@2026-04-09Latest activity on main branchMedium4/9/2026
main@2026-04-09Latest activity on main branchMedium4/9/2026

Dependencies & License Audit

Loading dependencies...

Similar Packages

GENesis-AGIAutonomous AI agent with persistent memory, self-learning, and earned autonomy. Cognitive partner that remembers, learns, and evolves.v3.0a7
openclaw-qaOpenClaw Q&A ็คพๅŒบ โ€” AI Agent ่ฎฐๅฟ†็ณป็ปŸใ€ๅคšAgentๆžถๆž„ใ€่ฟ›ๅŒ–็ณป็ปŸใ€ๅ…ท่บซAI | ้พ™่™พ่Œถ้ฆ† ๐Ÿฆžmain@2026-04-10
reinaAutonomous AI agent for Crustocean, powered by Hermes Agent from Nous Researchv1.0.0
Phantom Autonomous Offensive Security Intelligence AI-powered multi-agent penetration testingv0.8.0
openclaw-model-bridgeConnect any LLM to OpenClaw โ€” production-tested middleware for Qwen3-235B and beyondmain@2026-04-21