Skip to content

lhc5407/MOP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🤖 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) 내에서 실행하는 것을 강력히 권장합니다.

About

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).

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages