빠른 시작·설치
개요
OpenArms를 받아 개발·테스트 환경을 세우고 첫 연결까지 가는 과정입니다. 의존성의 권위는 코드
메타데이터(pyproject.toml·requirements-dev.txt)이고, 이 장은 그 위의 사람용 안내입니다.
요구 사항은 Python 3.9 이상입니다. 라이브 전경 실행석은 현재 tmux를 backend로 쓰므로, tmux가 자연히 도는 macOS·Linux·WSL2를 권합니다(Windows 네이티브는 비주력입니다).
환경별 설치
macOS · Linux
python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
python3 scripts/dev_preflight.py # 의존성 점검(설치·네트워크 없이 import만)
PYTHONIOENCODING=utf-8 python3 -m pytest -q라이브 전경 실행석으로는 tmux를 씁니다.
Windows (WSL2 권장)
Windows에서는 WSL2 안에서 위 macOS·Linux 단계를 그대로 따릅니다. 프로젝트 파일은 Windows 드라이브 마운트
가 아니라 WSL2 네이티브 홈(~/)에 두는 편이 파일 입출력에 유리합니다. Windows 네이티브의
hermes venv는 지원 테스트 러너가 아닙니다 — pytest·telethon이 없어 수집 자체가 되지
않습니다.
서버 (헤드리스 Linux)
서버에서도 같은 venv·pip 단계를 따릅니다. tmux가 전경 실행석이 되고, 메신저 연결은 환경 변수로 둡니다. 다만 현재 라이브 운영의 실증 권위 경로는 GUI 확인(Windows GUI + Mac VM 전경) 조합이라, 완전 헤드리스 운영은 사용자가 명명할 분화 버전 목표입니다 — 일부 작성중.
첫 연결 설정
- 홈 골격: OpenArms는
~/.openarms(또는OPENARMS_HOME)에 설정·자격·기억 골격을 둡니다. - 메신저: 현재 1차 어댑터는 텔레그램입니다. 봇 토큰과 대상 채널은 소유자 로컬 비밀이라
레포에 커밋하지 않고
.env로 둡니다(.env.example참조). - 프로바이더 CLI: Hermes·AGY·Claude 등은 외부 CLI입니다. OpenArms는 이들을 설치·패치하지 않고 어댑터로 붙입니다.
OS 지원 현황 (0.0.2.x)
| OS | 패키지·CLI·테스트 | 라이브 운영 |
|---|---|---|
| macOS · Mac VM | 가능 | 현재 전경·tmux 기준석 |
| Linux | 근거 있음(CI) | tmux 구조에 적합 |
| Windows | 가능(CI) | 비주력(GUI 확인 쪽) |
멀티 OS 동일 완전 사용은 사용자가 명명할 분화 버전 목표이지 현재 상태가 아닙니다. 세부 설치 문서(핵심 패키지·실행석·메신저·프로바이더 CLI 단계)는 순차적으로 채웁니다 — 일부 작성중.