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

1 Baptism이 뭔가요?

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

이 설치 하나로 생기는 것

✅ Termux 기본 패키지 (git, curl, proot-distro, openssh)

✅ proot-distro Ubuntu 환경

✅ DeepSeek API 키 등록 + 환경변수

✅ Aider (AI 페어 프로그래머) 설치 + 설정

✅ GitHub CLI 인증

✅ termux-bridge 레포 클론

✅ 설치 내역 BOM 보고서 생성

⚠️ 시작 전 확인

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 키보드에서 길게 누르면 붙여넣기)

$ BAPTISM — 메인 설치 명령어

# 이거 하나면 끝. Termux가 모든 걸 자동 설치합니다.
curl -fsSL https://raw.githubusercontent.com/dtslib1979/termux-bridge/main/install/baptism/baptism.sh | bash

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

Phase 0 Termux 기본 설정

git, curl, proot-distro, openssh 설치

Phase 1 proot Ubuntu 설치

3~5분 소요. Ubuntu 22.04 환경 구성

Phase 2 Ubuntu 패키지 설치

python3, pip, git, curl

Phase 3 🔑 DeepSeek API 키 등록

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

Phase 4 Aider 설치

AI 페어 프로그래머 (deepseek/deepseek-chat 모델)

Phase 5 GitHub 연결

토큰 또는 브라우저 인증. 3) 스킵도 가능

Phase 6 termux-bridge 클론

설치 자동화 레포 다운로드 + BOM 보고서 생성

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://raw.githubusercontent.com/dtslib1979/termux-bridge/main/install/baptism/boot.sh | bash

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

✅ Baptism 설치 완료!

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