Module 1: Baptism — 생초보 설치 가이드

1 Baptism이 뭔가요?

"에이전트 세례" — 생 폰을 AI 에이전트 워크스테이션으로 만드는 원클릭 설치입니다.

이 설치 하나로 생기는 것

✅ Termux 기본 패키지 (git, python, openssh, termux-api, proot-distro, nodejs)

✅ proot-distro Ubuntu 환경

✅ DeepSeek API 키 등록 + 환경변수

✅ Claude Code + Aider (DeepSeek wrapper) 설치

✅ 위젯 자동 배포 (레포 없어도 최소 2개는 항상 생성)

✅ SSH 키 생성 (GitHub 등록용 공개키 출력)

⚠️ 시작 전 확인

Wi-Fi 연결 필수 (약 500MB 다운로드).
배터리 50% 이상 또는 충전 중 권장.
Termux 앱은 F-Droid에서만 설치하세요 (Play Store 버전은 구버전).

2 설치 단계

총 3단계. 실제로 해야 하는 건 2번뿐입니다.

0 F-Droid + Termux 설치

Galaxy 폰에서:

설정 → 생체인식 및 보안 → 출처를 알 수 없는 앱 설치 → F-Droid 허용
또는 Galaxy Store에서 F-Droid 검색

브라우저에서 아래 주소 접속:

🌐 F-Droid 웹사이트

# 브라우저 주소창에 입력
https://f-droid.org/packages/com.termux/

F-Droid 앱을 먼저 설치한 뒤, F-Droid 앱 안에서 Termux 검색 → 설치.

Termux 설치 완료 후 한 번 실행 → 기본 설정이 완료됩니다
Termux:Boot도 함께 설치 권장 (재부팅 시 자동 실행)

💡 F-Droid 설치 링크: https://f-droid.org/F-Droid.apk

1 저장소 권한 허용

Termux를 처음 열면 저장소 권한을 물어봅니다. "Allow"를 누르세요.

$ 이미 지나갔다면 수동으로

# Termux 터미널에 입력
termux-setup-storage

⚠️ 저장소 권한이 없으면 이후 설치가 실패합니다. 반드시 허용.

2 원클릭 설치 실행

Termux 터미널에 아래 명령어를 복사해서 붙여넣기하세요. (Galaxy 키보드에서 길게 누르면 붙여넣기)

$ 진짜 원클릭 인스톨러 — g

# 이거 하나면 끝. 레포가 비공개라 clone이 실패해도 끝까지 완주합니다(자립형).
pkg install -y curl && curl -O https://dtslib1979.github.io/termux-bridge/g && bash g

⚠️ -O는 영문 대문자입니다

-0(숫자)로 치면 --http1.0 옵션이 되어 조용히 실패합니다. 실제로 이 오타 때문에 설치가 안 됐던 사고가 있었습니다.

실행하면 아래 순서로 자동 진행됩니다:

Phase 0 자기복제 시도

termux-bridge 레포 clone 시도. 실패해도(비공개) 단독 설치 모드로 계속 진행

Phase 1 🔑 DeepSeek API 키 등록

직접 입력하라는 창이 뜹니다. 미리 키를 복사해두세요

Phase 2 시스템 패키지

python, git, openssh, termux-api, proot-distro, nodejs

Phase 3 proot Ubuntu + 에이전트

5~10분 소요. Claude Code + Aider(DeepSeek) 설치

Phase 4 wrapper + 위젯 배포

claude-deepseek / aider-deepseek wrapper 생성, 위젯 자동 배포

Phase 5 SSH 키 + MCP

SSH 공개키 생성(GitHub 등록용)

💡 재부팅 시 자동 설치하려면 아래 Termux:Boot 스크립트를 먼저(Phase 0 전에) 실행: curl -fsSL https://dtslib1979.github.io/termux-bridge/install/baptism/boot.sh | bash

3 DeepSeek API 키 발급

Phase 3에서 API 키를 물어봅니다. 미리 준비하세요.

PC나 다른 폰 브라우저에서 아래 주소 접속:

🔑 DeepSeek API 키 발급 페이지

# 회원가입 → 로그인 → API Keys → Create new key
https://platform.deepseek.com/api_keys

API 키 복사 후 설치 화면에 붙여넣기

설치 중 API Key: _ 라는 입력 프롬프트가 나타나면 발급받은 키를 붙여넣고 엔터.

💡 키가 없어도 설치는 계속 진행됩니다. 나중에 ~/.env-deepseek 파일에 직접 추가 가능.

4 설치 완료 후

Baptism 완료 메시지가 나타나면 설치 성공.

✅ 설치 완료 시 확인 가능한 명령어

aider — AI 페어 프로그래머 실행

gh repo list dtslib1979 — 28개 레포 목록 확인

cd ~/termux-bridge && ls — 설치된 파일 확인

설치 후 Aider를 실행할지 물어봅니다. y를 입력하면 즉시 AI 프로그래밍 세션 시작.

5 문제해결

자주 발생하는 오류와 해결법

"pkg: command not found"

Termux가 아닌 일반 Linux 셸에서 실행 중입니다. 반드시 Termux 앱 안에서 실행하세요.

저장소 권한 오류

termux-setup-storage 명령어를 먼저 실행하고 "Allow" 버튼을 누르세요.

"git clone 실패"

네트워크 연결 확인. Wi-Fi가 불안정하면 데이터 네트워크로 전환 후 재시도.

개별 재시도: git clone https://github.com/dtslib1979/termux-bridge.git

proot Ubuntu 설치 중 멈춤

3~5분 정상 소요 시간입니다. 10분 이상 걸리면 Termux 앱을 완전히 종료 후 재시작 → 처음부터 다시 실행.

재부팅 후 자동 설치하고 싶다면

Phase 0 완료 후(아직 Ubuntu 진입 전), 아래 명령어로 부트 스크립트 설치:

$ Termux:Boot 자동설치

curl -fsSL https://dtslib1979.github.io/termux-bridge/install/baptism/boot.sh | bash

실행 후 폰 재부팅 → Termux:Boot가 자동으로 설치 완료.

✅ Baptism 설치 완료!

다음 강의: 위젯 8개 마스터 →