Mothership
로컬에서 띄우기
SQLite로 Mothership을 띄우고, 회사를 하나 열고, Golden Image의 예제 앱을 올려 직원 카탈로그에 게시해요.
필요한 것
- Python 3.12 이상, Node.js 22.13 이상, pnpm 11.20.0
- (선택) OCR과 PDF 변환:
sudo apt-get install tesseract-ocr tesseract-ocr-eng tesseract-ocr-kor poppler-utils
SDK 묶음은 저장소의 vendor/에 들어 있어서 옆 저장소 없이 빌드돼요.
띄우기
bash
make backend-install # .venv와 백엔드 의존성
make frontend-install # 호스트 콘솔(frontend/)
cp -n .env.example .env
make migrate
make demo # 개발용: admin@example.com 운영자, demo 회사
make dev # :8000 (API, 콘솔 빌드 감시, 워커를 함께)
http://localhost:8000/login을 열고 admin@example.com을 넣어요. SMTP가 없으면 6자리 코드가 서버 로그에 찍혀요.
make dev는 ASGI 게이트웨이, 콘솔 빌드 감시(vite build --watch), 백그라운드 워커를 함께 돌려요. 따로 돌리려면make dev-api와make dev-workers예요.- 내 주소를 운영자로 만들려면
.env의ADMIN_EMAILS에 넣고python backend/manage.py ensure_operators를 해요.


회사를 열고 앱 올리기
make demo의 계정은 서비스 운영자이고 demo 회사의 일반 구성원이라서, 그 회사에는 앱을 올릴 수 없어요. 내 회사를 하나 열어요.
-
서비스 관리 → 회사와 사람 → 회사에서 회사 이름, 회사 주소(slug), 소유자 이메일을 넣고 회사 개설. 화면에 뜬 초대 링크를 열고 초대 수락하고 시작을 눌러요.


서비스 관리 → 회사. 새 회사를 열고 첫 소유자를 초대해요. -
옆 저장소에서 예제 앱을 빌드해요.
bash(cd ../golden-image && make setup && make build) -
업무 앱 → 카탈로그 관리 → 앱 추가에서
golden-image/frontend/dist/my-project-<버전>.zip을 올려요. 새 앱의 후보 버전이 돼요. -
앱의 버전·환경 탭에서 검토 후보로 접수 → 공동 검증에 올리기 → 승인 → 운영에 반영을 차례로 해요. → 앱 올리기와 배포
-
카탈로그 정보에서 이름과 설명을 정하고 운영 카탈로그에 게시를 켜요. 업무 앱에 앱이 나타나요.
모델 켜기
예제 앱의 질문과 지식 검색에는 모델이 필요해요. OpenAI 호환 서버를 .env에 넣고 다시 띄워요. 회사마다 회사 관리 → AI 연결에서 따로 정할 수도 있어요.
bash
MOTHERSHIP_AI_API_KEY=sk-...
MOTHERSHIP_AI_BASE_URL=https://llm.example.com/v1 # 비우면 api.openai.com
MOTHERSHIP_AI_MODEL_SMART=<모델> # fast·deep이 없으면 smart가 대신해요
MOTHERSHIP_AI_MODEL_EMBEDDING=<임베딩 모델> # 선택: 없으면 지식 검색은 문자열 검색만
테스트
bash
make test # pytest + 콘솔 vitest
make check # ruff + 콘솔 타입 검사