OpenMinion: 도구 사용 AI 에이전트를 위한 Python 우선, 로컬 우선 런타임

Python 기반, 로컬 환경 중심의 도구 사용 AI 에이전트 런타임입니다.

GitHub · PyPI · Website · Docs · X

OpenMinion은 자체 장치에서 검사 가능한(inspectable) 에이전트를 실행하기 위한 런타임의 공개 프리뷰 버전입니다. 하나의 공유된 런타임으로 CLI, Python API, HTTP API, 그리고 데몬 기반 워크플로우를 아우르며, 내구성이 있는 세션(durable sessions), 구조화된 도구(structured tools), 검사 가능한 실행 상태(inspectable run state)가 기본적으로 구축되어 있습니다. 장시간 자율성(Long-running autonomy), 실시간 제공자 복원력(live provider resilience), 메모리/컨텍스트 유용성에 대한 주장은 알파 기간 동안 증명 단계에 남아있습니다.

• 현재 제품 경계를 확인하려면 'Read At a Glance'를 읽으세요.

• 로컬 실행을 하려면 'Follow Install and Quick Start'를 따르세요.

• CLI, Python, HTTP 또는 데몬 기반 작동 중 어떤 것을 선택할지는 'Runtime Surfaces'를 사용하세요.

• 런타임을 변경하기 전에는 'Read Development'를 읽으세요.

• 전체 운영자 및 기여자 매뉴얼은 문서 사이트(documentation site)를 이용하세요.

• 공식 GitHub: https://github.com/OpenMinion/openminion

• 공식 웹사이트 및 문서: https://www.openminion.com

• 공식 X 계정: https://x.com/OpenMinion

OpenMinion은 공식 토큰, 코인, NFT, 에어드롭, 스테이킹 프로그램, 트레저리 상품 또는 투자 제안을 가지고 있지 않습니다. 달리 주장하는 모든 것은 무단이며 사기로 간주해야 합니다.

| 패키지 | openminion |
| 현재 버전 | 광범위하게 사용 가능한 소스/CLI 마일스톤의 0.1.x 공개 프리뷰 |
| Python | 3.11+ |
| ... |
OpenMinion은 오늘날 집중적인 로컬 작업에 사용할 수 있지만, 여전히 활발히 개발 중입니다. 복잡한 종단 간(end-to-end) 프롬프트와 장시간의 비감독(unsupervised) 작업은 아직 개선되고 있습니다. 현재 2시간 자율성 인증 지원은 검증 전용이며, 전체 8시간 및 24시간 실시간 경과 인증 파일럿에는 여전히 승인된 실행 창(run window), 제공자/모델 접근 권한, 워크스페이스, 그리고 예산이 필요합니다.

0.1.x 호환성 계약은 문서화된 Python 및 CLI 표면을 다룹니다. 이는 서명된 데스크톱 바이너리, 관리형 클라우드 서비스 또는 완료된 장기 자율성 인증을 주장하지 않습니다.

openminion config init
openminion setup --list-providers
openminion setup --list-providers --json
...

유용한 연산자 표면(Useful operator surfaces):

openminion agent ls
openminion agent status --agent-id default
openminion agent logs
...

현재 패키지를 격리된 명령줄 앱으로 설치합니다:

pipx install openminion

또는, uv를 사용하여:

uv tool install openminion

기존 Python 환경에 설치하는 것도 지원됩니다:

python3.11 -m pip install openminion

소스 코드를 체크아웃할 경우:

git clone https://github.com/OpenMinion/openminion.git
cd openminion
python3.11 -m venv .venv
...

Windows PowerShell에서는 다음 명령어로 동일한 환경을 활성화합니다:

.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e .

개발 중 격리된 로컬 데이터를 위해:

export OPENMINION_HOME="$PWD"
export OPENMINION_DATA_ROOT="$OPENMINION_HOME/.openminion"

실제 모델 기반 세션을 위해서는 기본 명령어로 시작합니다:

openminion --version
openminion --dir "$PWD"

설정 시 제공자(provider), 모델, 자격 증명(credential)을 요청합니다. 내장된 제공자의 경우 OpenMinion이 API 어댑터를 자동으로 선택합니다. 예를 들어, MiniMax는 OpenAI와 호환되는 API를 사용하더라도 제공자로 MiniMax를 유지합니다. 호스팅 제공자 확인 단계에서 Enter 키를 누르면 Focus가 열리기 전에 권장 테스트 요청을 한 번 전송할 수 있으며, 이 요청은 소량의 할당량을 소비할 수 있습니다. 현재 사람이 읽기 쉬운 목록 또는 기계가 읽기 쉬운 카탈로그는 위의 provider-list 명령어를 사용하십시오.

명시적인 --dir

t는 해당 작업 공간을 현재 프로세스가 신뢰하도록 합니다. 기본 실행도 일반 Git 작업 트리를 신뢰합니다. 다른 암묵적 디렉토리는 읽기 전용입니다. 홈 디렉토리나 파일 시스템 루트에서 실행하려면 명시적인 --dir PATH를 사용해야 합니다.

현재 프로세스에 추가 기존 디렉토리를 추가하려면 반복 가능한 --add-dir PATH 옵션을 사용합니다:

openminion --dir "$PWD" --add-dir ../shared

구조화된 파일 도구는 작업 공간, 명시적으로 추가된 디렉토리 및 구성된 정책 루트 내에 제한됩니다. 샌드박스가 구성되지 않은 경우 호스트 명령어는 비활성화 상태로 유지됩니다. --allow-unsandboxed-exec

명시적인 옵트인(opt-in) 방식입니다: 명령을 실행할 때 OpenMinion 프로세스의 OS 권한을 사용하며, 작업 공간 루트에 국한되지 않습니다. 명령어 정책 및 승인은 여전히 적용됩니다. 네이티브 로컬 샌드박스나 승인 없는 명령어 동등성(command parity)은 아직 제공되지 않습니다.

설정이 완료되고 대화형 CLI가 열리면 다음을 요청하세요: 파일 도구를 사용하여 이 작업 공간 목록 보기(List this workspace using the file tools).

기본 설정은 ~/.openminion/agents.json에 저장되므로, 다음에 아무것도 지정하지 않고 실행하면 이를 재사용합니다.

크리덴셜이 필요 없는 제품 투어를 위해 명시적인 echo/데모 설정을 만드세요:

openminion config init --provider echo
openminion run "hello"
openminion status readiness

데모 모드는 설정, 저장소(storage), 세션, CLI 파이프라인을 연습하지만, 모델을 호출하거나 제공자 지원 작업 품질을 입증하지는 않습니다. 준비 상태 보고서(Readiness reports)에서는 이 상태를 ready가 아닌 demo로 표시합니다.

대화형 CLI를 여세요:

openminion --dir "$PWD"

명시적인 런타임 루트를 가진 두 개의 구성된 에이전트를 하나의 Focus 룸에서 실행하세요:

runtime_root="$PWD/.openminion-room"
config_path="$HOME/.openminion/agents.json"
room_output="$(openminion \
...

Focus 내부에서는 /participants를 사용하여 룸을 검사하고, /routing broadcast 또는 /routing sequential를 사용하여 모드를 변경하며, @reviewer로 하나의 에이전트에게 주소를 지정할 수 있습니다. 룸 수정은 로컬 소유자만 필요하며, 참가자는 게시할 수 있지만 관찰자는 할 수 없습니다.

Python에서 격리된 에이전트 세션을 임베드하세요:

from openminion import Agent, ProviderError, tool
@tool
def lookup_order(order_id: str) -> str:
...

프로젝트 소유의 설정을 사용하려면 config_path="path/to/agents.json"을 전달하고, 구성된 프로필 중 하나를 선택하려면 agent_id="reviewer"를 전달하세요. 고급 런타임 조합(runtime composition)을 위해서는 APIRuntime을 직접 구성하여 대신 runtime=으로 전달하세요.

완전한 실행 예제는 examples/starter/quickstart.py에서, 기여자 부트스트랩은 docs/getting-started.md에서 확인하세요.

• CLI, Python, HTTP 및 데몬 백킹(daemon-backed) 경로 전반에 걸친 단일 오케스트레이션 모델
• 로컬 및 호스팅된 모델 백엔드를 위한 제공자 추상화(provider abstraction)
• 모델 기반 계약(model-facing contracts)과 정책 게이팅 실행을 갖춘 구조화된 도구
• 영속적인 로컬 세션, 실행(run), 아티팩트, 메모리 기록 및 대화 상태 관리
• 인터랙티브 및 일회성 로컬 워크플로우
• 진단(diagnostics), 상태(status), 로그, 검사(inspection) 및 OpenTelemetry 준비 트레이스
• 도구, 제공자, 스킬, 메모리 및 통합을 위한 확장 표면(extension surfaces)

"어떤 복잡한 작업이든 맡기고 떠날 수 있는" 완성된 자율성
호스팅되는 제어 평면(control plane) 또는 관리형 클라우드 에이전트 서비스
구성된 제공자 자격 증명과 승인된 실행 기간 없이 제공자 백킹 인증 증명서
런타임 상태를 숨기는 블랙박스 프롬프트 래퍼(prompt wrapper)
안전하지 않거나 특권적인 작업을 수행할 수 있는 자동 권한 부여
모든 암호화폐 또는 투자 상품

루트 패키지는 다음 지원되는 Python 파사드(facade)를 내보냅니다: APIRuntime, Agent, AgentOutputValidationError, AgentRunResult, Handoff, MemoryBundle, OpenMinionConfig, ProviderError, subagent, tool, 그리고 __version__. 더 깊은 패키지 내부 구조에 의존하기 전에 API_COMPATIBILITY.md를 참조하십시오.

Agent.run_stream()은 동기식 콜백-진행도 편의 API입니다. 타입이 지정된 이터레이터 스트리밍(iterator streaming), 취소(cancellation) 또는 스트림 처리되는 승인 해결을 위해서는 APIRuntime.submit_turn()과 openminion.api에서 내보내는 고급 계약을 사용하십시오. 두 흐름 모두에 대해서는 examples/sdk/를 참조하십시오.

src/openminion/
api/ Public Python 및 HTTP 런타임 진입점
base/ 기반 계약(Foundational contracts) 및 공유 기본 요소(shared primitives)
...

소유자별 상세 정보는 docs/source-tree-owner-map.md를 읽어보세요.

기여하기 전에 CONTRIBUTING.md와 CODE_QUALITY.md를 읽어보세요.

make dev-install
make hooks-install
make lint

반복 작업 시에는 집중적인 테스트(focused tests)를 사용하세요. 기능 승인(feature sign-off) 전에 make lint를 실행하고, 의도적으로 더 광범위한 통합 검사(broader integration sweep)는 make check에 할당하세요.

docs/README.md

: 패키지 문서화 맵 (package documentation map) docs/runtime-surfaces.md
: 지원되는 런타임 및 라이브러리 표면(supported runtime and library surfaces) docs/system-operations.md
: 로컬 작업 및 진단(local operation and diagnostics) docs/security-scanning.md
: 제한된 로컬 Semgrep 및 Trivy 감사(bounded local Semgrep and Trivy audits) docs/testing-and-validation.md
: 검증 인벤토리 (validation inventory) docs/certification-readiness-matrix.md
: 현재 증명 커버리지 (current proof coverage) API_COMPATIBILITY.md
: 공개 임포트 및 명령어 호환성 (public import and command compatibility) RELEASING.md
: 릴리스 검사 및 게시 흐름(release checks and publish flow)

모델 제공업체 비용, 호스팅 서비스, 제3자 인프라는 Apache-2.0 라이선스가 적용된 런타임과는 별개입니다. 유료 백엔드를 활성화하기 전에 제공업체 약관과 비용을 검토하세요.

• 소스 코드 라이선스: Apache-2.0
• 브랜드/상표권 부여: 없음(none)

이 라이선스는 코드를 사용, 수정 및 재배포할 권리를 부여합니다. 이로 인해 포크(fork), 클론(clone), 토큰(token), 웹사이트 또는 소셜 계정을 공식 OpenMinion 프로젝트로 제시하거나 제휴 또는 지지를 암시하는 권리는 부여되지 않습니다.