영수증을 던지면 AI 둘이 내 지갑을 두고 싸운다 — PyCon Korea 2026 튜토리얼
일시: 2026년 8월 17일(월) 10:00–13:00 · 공간 1
영수증 사진 한 장이 AI들의 열띤 토론으로 바뀝니다. 이 튜토리얼에서는 파이썬과 생성형 AI로 "스스로 가계부를 쓰고 내 소비를 두고 티격태격 토론하는" 미니 앱을 직접 만듭니다.
영수증 1장, 총 지출 4,800원
- 카페/간식: 4,800원 (100%)
<자린고비 할머니>
오매, 입가심 한 번에 사천 팔백 원을 써버리다니, 내 젊을 적엔 그 돈이면
온 식구가 뜨끈한 시래깃국에 보리밥으로 며칠은 배를 채웠단다.
<YOLO 인플루언서>
단돈 4,800원으로 오늘 하루를 행복하게 채웠다면 그것만으로 이미 값진 자산이니,
앞으로도 당당하게 멋진 경험들을 채워가길 응원해요!
[판정] 재무 건강 점수: 75점
파이썬을 미리 설치하지 않으셔도 됩니다. 아래 1번에서 설치할 uv라는 도구가
알아서 받아옵니다. 전부 합쳐 10분이면 끝납니다.
| 맥 | Command + Space → "터미널" 입력 → Enter |
| 윈도우 | 시작 메뉴에서 "PowerShell" 검색 → 실행 |
| 리눅스 | Ctrl + Alt + T |
까만 창이 하나 뜨고 커서가 깜빡이면 준비된 것입니다. 여기에 아래 명령들을
한 줄씩 복사해 붙여넣고 Enter를 누르시면 됩니다.
uv는 파이썬 프로젝트를 관리해주는 도구입니다. 파이썬 자체도 이 도구가
설치해 줍니다.
맥 / 리눅스
curl -LsSf https://astral.sh/uv/install.sh | sh윈도우 (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"설치가 끝나면 터미널을 완전히 닫았다가 다시 열어 주세요. 그래야 uv 명령을
찾을 수 있습니다. 다시 열고 아래를 실행해 버전이 나오면 성공입니다.
uv --version❌
command not found: uv가 나온다면 터미널을 아직 다시 열지 않으신 겁니다. 창을 닫고 새로 열어 보세요.
git clone https://github.com/mindori/pycon2026.git
cd pycon2026
git이 없다는 메시지가 나오면, 이 페이지 위쪽 초록색 Code 버튼 → Download ZIP 으로 받아 압축을 푸셔도 됩니다. 이 경우 폴더 이름이pycon2026-main이 되므로cd pycon2026-main으로 들어가세요.
uv sync이 한 줄이 파이썬 3.11과 필요한 라이브러리를 전부 받아옵니다. 컴퓨터에 이미 있는 파이썬을 건드리지 않고, 이 폴더 안에만 따로 설치하니 안심하셔도 됩니다. 처음 실행할 땐 1~2분 걸릴 수 있습니다.
발급받지 않으셔도 됩니다. 실습용 Gemini API 키를 강사가 만들어 등록하신 메일로 보내드립니다. 비용도 강사가 부담합니다.
- 8/16(일) 사전 점검 전후에 발송됩니다. 제목은 "[PyCon 튜토리얼] AI 가계부 배틀 — 실습용 API 키" 입니다. 스팸함도 확인해 주세요.
- 못 받으셨으면 당일 현장에서 메일 주소만 알려 주시면 바로 보내드립니다.
키를 받으셨으면:
맥 · 리눅스
cp .env.example .env윈도우 (PowerShell)
copy .env.example .env그리고 만들어진 .env 파일을 편집기로 열어 메일로 받은 키를 붙여넣으세요.
앞뒤에 따옴표나 공백을 넣지 마세요.
GOOGLE_API_KEY=여기에_강사가_보낸_키를_붙여넣으세요
튜토리얼이 끝나면 이 키는 폐기됩니다. 집에서 계속 해보시려면 본인 키를 직접 발급받으세요 — 무료이고 신용카드도 필요 없습니다. 발급 방법 (3분)
uv run python check_env.py✅ 가 다섯 개 나오면 준비 끝입니다. ❌ 가 있으면 화면에 무엇을 해야 하는지 함께 나옵니다. 그대로 따라 하시면 됩니다.
uv run python main.pyreceipts/ 폴더에 들어 있는 샘플 영수증으로 전 과정이 돌아갑니다. AI 둘이
토론하고 마지막에 점수가 나오면 성공입니다.
- 노트북 (맥 / 윈도우 / 리눅스 무관)
- API 키는 준비 안 하셔도 됩니다 — 강사가 메일로 보내드립니다
- 본인 영수증 3~5장 (선택)
💡 품목이 찍힌 영수증이 좋습니다. 편의점·카페·마트 영수증처럼 무엇을 샀는지 줄줄이 적힌 것이요. 카드 결제 전표(가맹점명과 승인금액만 있는 종이)만 있으면 AI가 "어디서 얼마"까지만 알 수 있어 토론이 심심해집니다.
감열지 영수증은 시간이 지나면 글자가 날아갑니다. 받는 즉시 사진으로 찍어두세요. 없어도 괜찮습니다 — 샘플이 들어 있습니다.
| 단계 | 배우는 것 |
|---|---|
| 본다 | Vision LLM으로 영수증을 읽고, Pydantic 구조화 출력으로 들쭉날쭉한 LLM을 안정적인 함수처럼 다루는 법 |
| 정리한다 | 카테고리별 집계. LLM 없이 순수 파이썬으로 |
| 토론한다 | 페르소나 프롬프트 설계, 그리고 초급자가 가장 자주 빠지는 멀티에이전트 무한 루프를 막는 종료 조건 설계 |
| 판정한다 | 판정관 AI가 토론을 종합해 재무 건강 점수와 처방전을 내놓기 |
수료 후 멀티모달 입력 → 구조화 출력 → 멀티에이전트 오케스트레이션 이라는 요즘 AI 앱의 핵심 뼈대를, 완성된 미니 앱과 함께 손에 넣게 됩니다.
대상: 파이썬 기본 문법(변수·함수·반복문)만 아시면 충분합니다. AI를 코드로 다뤄본 적이 없어도 끝까지 따라올 수 있도록 설계했습니다.
25명이 당일 아침에 동시에 설치하면 실습 시간을 잃습니다. 미리 해주세요.
설치 가이드 (10분) — 위 "처음이신가요"의 자세한
버전입니다. uv 설치와 저장소 내려받기까지만 하시면 됩니다. 막히는 부분이 있으면
이쪽을 보세요.
API 키는 미리 준비하실 게 없습니다. 강사가 메일로 보내드립니다 — 자세히.
키를 받아 .env에 넣으시면 uv run python check_env.py가 ✅ 다섯 개를 출력합니다.
혼자 해결이 어려우시면 8/16(일) 저녁 온라인 사전 점검에서 함께 봐 드립니다.
미리 읽어 오실 필요 없습니다. 당일 이걸 보며 함께 진행합니다.
| 막 | 문서 | 시간 |
|---|---|---|
| 0막 | 환경 점검과 첫 호출 | 20분 |
| 1막 | 본다 — 영수증을 데이터로 | 30분 |
| 2막 | 정리한다 — 가계부 만들기 | 10분 |
| 3막 | 토론한다 — 페르소나와 종료 조건 | 25분 |
| 4막 | 판정관과 피날레 | 15분 |
진도가 밀려도 괜찮습니다. 각 막 문서 맨 위에 혼자 따라잡는 방법이 있습니다. 손 들지 않고도 합류할 수 있게 만들어 뒀습니다.
| 증상 | 해결 |
|---|---|
command not found: uv |
터미널을 닫았다가 다시 열어 보세요 |
GOOGLE_API_KEY를 찾을 수 없습니다 |
.env 파일을 만들고 키를 넣으셨는지 확인 (5번) |
unsupported operand type(s) for | |
폴더를 옮기셨나요? 가상환경을 지우고 다시 만드세요 → 설치 가이드 |
| 실행이 멈춘 것 같아요 | 무료 티어 분당 한도입니다. 자동으로 다시 시도하니 잠시 기다리세요 |
| 그 외 | 설치 가이드의 문제 해결 절 |
budget_battle/ 핵심 패키지 (config, client, vision, ledger, personas, debate, judge)
main.py CLI 엔트리
app.py 피날레용 Streamlit 앱
check_env.py 환경 진단 스크립트
receipts/ 샘플 영수증
docs/prework/ 사전 준비 안내
docs/handbook/ 당일 막별 교재
steps/ 막별 완성 스냅샷 (진도를 놓쳤을 때 복구용)
tests/ 테스트
MIT License. 학습·실습 목적으로 자유롭게 활용하셔도 됩니다.