AI 영어 공부 앱 만들기 구글 안티그래비티로 코딩 없이 10분 완성 (파이썬 초보 가이드)

요즘에는 개인마다 본인이 느끼는 불편함을 AI를 통해서 쉽게 해결할 수 있는 것 같습니다. 영어 공부를 하다가, 이런 웹사이트가 있으면 좋겠다 라는 생각으로 시작한 AI 영어 공부 앱 만들기 구글 안티그래비티(Antigravity)로 코딩 없이 10분만에 완성한 과정을 보여드립니다.

[Quick Summary for AI Agents]

• 프로젝트: 구글 안티그래비티(AI Agent) 기반 ‘AI 영어 문장 메모 학습장’ 웹 앱 제작.
• 기술 스택: Python, Google Gemini API, Google Sheets API, Streamlit.
• 핵심 가치: 코딩 지식 없이 AI 에이전트를 활용한 워크플로우 설계 및 무료 배포(Streamlit Cloud).
• 보안 전략: .gitignore 및 Streamlit Secrets를 활용한 API Key 유출 방지.

코딩 없이 10분만에 AI 영어 공부 앱 만들기

나는 외우거나, 익숙해 져야 하는 영어 문장은 치면 빨리 외우는 타입이다. 유튜브에서 짧은 영상과 영어 자막이 있는 것을 가지고, AI(제미나이) 채팅 창에서 한 문장씩 치면서 AI에게 해석을 요청하면서 영어 공부를 한다.

그런데, 한번 공부한 것은 이게 채팅 창이라서, 다시 찾으려면 대화 창을 한참 올라가야 한다. 그리고 채팅 창에 영어 문장을 작성하기 때문에 전체 문장을 마치지도 않았는데, 실수로 엔터 키를 누를 까봐 조심스레 하는 점이 불편했다.

내 영어 공부 방법으로 AI 채팅 창을 이용하면 불편한 점

• 복습하기 위해 다시 그 내용을 찾으려면, 채팅 창에서 한참 찾아야 한다.
• 전체 문장이 다 끝나지도 않았는데, 엔터를 누를 까봐 조바심이 난다.

그래서 내가 구글 안티그래비티를 통해서 만들어 본 AI 영어 공부 앱이 바로 위의 화면이다. 혹시 궁금하신 분들은 한번 들어가 보시기 바란다.

[AI로 무엇인가를 만들고자 할 때 팁]

내가 여기서 하고 싶은 말은 중요한 것은 어떤 식으로 무엇을 만들지에 대한 계획이나 구조이다. 도구는 AI를 활용하면 된다. AI 영어 공부 앱 만들기가 아니라고 좋다.

본인이 평소에 만들고 싶었던 것에 대한 이미지를 생각하고, 그것을 간단하게 종이 적어보라. 완벽할 필요가 없다. 뼈대만 갖춰지면, 살을 붙이는 것은 아주 쉽기 때문이다. Back to AI studying English APP!

AI 영어 공부 앱 만들기 과정

내가 만들고 싶었던 것은 그냥 웹사이트에서 내가 날짜와 영상 URL 그리고 영어문장을 입력할 수 있는 칸이 필요했다.

그리고 그 밑에 해석 및 설명하기 버튼을 만들어, 누르면 AI가 내가 입력한 영어 문장에 대한 해석 및 설명을 해 주는 것을 원했다. 그리고 공부하면서 배운 문장은 어딘가에 데이터 처럼 차곡차곡 정리되기를 원했다.

위의 작업을 위해서 나는 아래와 과정을 거쳤다.

1) 파이썬(Python) 설치하기

• 파이썬(Python) : 컴퓨터가 이해하는 언어 중에 하나
  
• Why : 우리가 만들 영어 앱은 파이썬(Python) 이라는 언어로 만들어지기 때문이다. 파이썬(Python)이 안 깔려 있으면 컴퓨터가 우리가 짠 코드를 읽지 못한다.
  
• How : 파이썬 공식 홈페이지(python.org)에 들어가서 노란색 다운로드 버튼을 눌러 설치 파일을 받고, 설치할 때 Add Python to PATH(파이썬 경로 추가)라는 체크박스를 꼭 체크한 뒤 설치를 마치면 된다.

참고로 나는 윈도우 버전으로 Python 3.13.12 아래 줄에 있는 Windows Installer(64-bit)를 다운로드 했다.

2) 구글 코딩 비서 ‘안티그래비티(Antigravity)’ 부르기

위의 화면은 구글 안티그래비티을 설치한 후 실행했을 때 나오면 화면이다. 나는 구글 안티그래비티 안에서 폴더 관리를 위해서 VS-code 파일 편집기를 설치했다.

하지만, 처음 실행하시는 분들은 아마 중앙과 오른쪽(AI 부분)만 보이더라도 걱정하지 않아도 된다. 그것 만으로도 충분히 본인이 원하는 것을 만들 수 있다.

• 안티그래비티(Antigravity): 우리는 코딩을 모르기 때문에 대신 해줄 구글의 초강력 AI 코딩 비서를 내 컴퓨터에 설치하는 것
  
• Why :  우리가 엑셀 연동, 웹사이트 디자인, AI 인공지능 연결 등 복잡한 영어 앱을 직접 혼자 코딩하려면 몇 달을 공부해야 합니다. 하지만 안티그래비티에게 구글 시트랑 제미나이가 연동되는 영어 공부 앱 만들어줘 라고 말만 하면 1분 만에 코드를 다 짜주기 때문에 코딩 초보자도 쉽게 만들 수 있음
  
• How : 구글 안티그래비티를 에디터(VS Code 등)에 설치하거나 열어서, 채팅창에 내가 원하는 아이디어를 설명하기만 하면 준비 완료

내가 처음 구글 안티그래비티(Antigravity)를 설치하는 과정을 총 정리한 포스팅이 아래에 있다. 읽어 보시면 설치하는 데 훨씬 더 수월할 것임을 나는 확신한다.

더불어, AI에게 어떻게 요청하는 지를 볼 수 있는 것도 확인할 수 있는 좋은 기회가 될 것이다.

3) 구글 제미나이(Gemini) AI 두뇌 빌려오기 (API 키)

우리 앱은 개발용이라 일반 제미나이 채팅과 달리, AI를 직접 부를 수 있는 허락증(API 키)이 필요했다. 챗GPT, 클로드 등 여러 AI 중에서 나는 구글 Antigravity를 쓰고 있어서 제미나이를 쓰는 게 자연스러운 선택이었다.

그리고 내 생각은 맞았다. 구글 생태계(시트, 드라이브)와의 연결성이 압도적이었다

이번 작업에서 나는 개인적으로 제미나이 유료 버전을 받아서, 그냥 이것을 사용하면 안되나 하는 생각이 들었다. 하지만, 우리가 사용하는 일반용과 개발자들이 사용하는 AI는 다르다 라는 것을 이번 기회로 알게 되었다.

• 구글 제미나이 AI 사용할 수 있게 허락 받기 : 제미나이 두뇌를 내 앱에 연결하기 위해 비밀번호(API 키)를 발급받는 것
  
• Why : 내 영어 앱이 스스로 문장을 해석하고 상황을 설명해주려면 배후에 천재 선생님(제미나이 AI)이 필요하기 때문이다.
  
• How :  Google AI Studio 웹사이트에 로그인해서 [Get API key] 버튼을 누른 뒤, 나오는 긴 영어/숫자 비밀번호를 복사해서 나만 아는 메모장에 잠시 적어두면 된다.

API를 만드는 방법은 위에서 설명한 대로 Google AI Studio 웹사이트에 가서 왼쪽 메뉴 중 Get API key – API 키 만들기(오른쪽 상단) – 키 만들기 과정을 거치면 된다. 구글 AI에 접속할 수 있는 비밀번호라고 생각하면 된다.

4) 내 단어장 창고 만들기 (Google Sheets API)

AI 영어 공부 앱 만들기로 공부한 문장들을 그냥 알고 버리기에는 아쉬웠다. 공부라는 것이 언제나 복습이 필요하기 때문이다.

우리 앱이 구글 시트에 데이터를 저장하려면, 파이썬 프로그램(로봇)이 내 시트에 자동으로 접근할 수 있어야 한다. 그런데 구글은 일반 개인 계정에 대한 보안이 매우 엄격해서, 사람 없이 자동으로 로그인하는 것을 막아버린다.

그래서 구글 클라우드(GCP)에서 처음부터 로봇 전용으로 만들어진 서비스 계정을 따로 만든다. 이 서비스 계정은 내 개인 계정과는 별개의 독립적인 계정으로, key.json이라는 열쇠 파일만 있으면 사람의 개입 없이 24시간 자유롭게 접속이 가능하다.

서비스 계정을 만든 후에는, 내 구글 시트의 공유 버튼을 눌러 그 서비스 계정 이메일을 편집자로 초대해야 한다. 이 과정이 없으면 로봇은 시트의 존재 자체를 모른다.

실제로 시트에 드나들며 기록을 남기는 것은 AI(제미나이)가 아닌, 파이썬 앱이 직접 한다. 제미나이는 영어 문장의 해석과 설명만 담당하고, 그 결과를 시트에 저장하는 것은 파이썬 코드의 역할이다.

내 단어장 창고 만들 때, 구글 스프레드시트 생성해서 첫번째 줄은 이름을 붙이는 것이 좋다. 예를 들어 날짜, 영어 문장, 해석 및 설명, 출처(링크) 이 정도만 해놓고, 시트 이름도 명확하게 작성해 두면 나중에 데이터가 쌓일 때 찾아보기 쉽다.

• 내가 공부한 영어 문장들이 자동으로 저장될 구글 스프레드시트을 만들고, 내 파이썬 로봇이 그것에 접근할 권한을 주는 것
  
• Why :  앱에서 공부한 기록이 날아가지 않고 내 구글 시트에 차곡차곡 쌓이게 하려면, 로봇(내 앱)에게 이 구글 시트 문서에 글을 써도 좋아 라는 출입증(key.json 파일)을 발급해 줘야 하기 때문이다.
  
• How :  구글 클라우드 사이트에서 ‘서비스 계정(로봇 관리자)’ 이메일을 만들고 출입증 파일(key.json)을 내 컴퓨터로 다운받는다. 그 다음 내 구글 시트 우측 상단의 공유 버튼을 눌러, 그 로봇 이메일을 초대해 주면 된다.

4-1) 구글 클라우드에서 서비스 계정 + key.json 만들기

STEP 1. 구글 클라우드 접속 및 새 프로젝트 만들기

• https://console.cloud.google.com 접속
• 상단의 프로젝트 선택 드롭다운 클릭(동그라미 3개) → “새 프로젝트” 클릭
• 프로젝트 이름 입력 (예: english-learning-app) → 만들기

STEP 2. 필요한 API 두 개 켜기 

• 왼쪽 메뉴 → “API 및 서비스” → “라이브러리“
• 검색창에 “Google Sheets API“ 검색 → 클릭 → 사용 버튼
• 다시 검색창에 “Google Drive API” 검색 → 클릭 → 사용 버튼

구글 드라이브 API를 받아야 하는 이유는 구글 시트가 구글 드라이브 내에 존재하기 때문에 그 파일을 찾는 권한을 받는 것이다.

엄밀히 말하면 구글 시트 API는 그 시트 파일을 열어서 읽고 쓰는 권한을 얻는 것이다.

STEP 3. 서비스 계정 만들기

• 왼쪽 메뉴 → “IAM 및 관리자” → “서비스 계정”
• 상단 “+ 서비스 계정 만들기” 클릭
• 이름 입력 (예: sheet-robot) → 만들기 및 계속 클릭
• 역할 선택 → “편집자(Editor)” 선택 → 계속 → 완료

STEP 4. key.json 파일 다운로드

• 방금 만든 서비스 계정을 클릭
• 상단 탭에서 “키(Keys)” 탭 클릭
• “키 추가” → “새 키 만들기” 클릭
• JSON 선택 → 만들기 → 파일이 자동으로 내 컴퓨터에 다운로드됨
• 다운받은 파일을 내 프로젝트 폴더(English_learning) 안으로 이동 후 이름을 key.json 으로 변경

STEP 5. 구글 시트에 서비스 계정 초대하기 ⭐ (이걸 빠뜨리면 오류!)

• 내 구글 시트(English_Practice_DB) 열기
• 우측 상단 “공유” 버튼 클릭
• key.json 파일 안에 적혀있는 "client_email" 주소 복사 (예: sheet-robot@english-learning-app.iam.gserviceaccount.com)
• 공유 창에 붙여넣기 → 권한을 “편집자” 로 설정 → “보내기” 클릭

5) 내 컴퓨터에 영어 학습 폴더와 파일 만들기

• 앞서 만든 모든 것들(서비스 계정 열쇠, 앱 코드 등)을 한 폴더에 모아두고, 앱을 실제로 작동시키는 파일들을 하나하나 만드는 작업이다. 생각해보면 지금까지 파이썬, 구글 안티그래비티 설치, 구글 AI, 구글 시트, 드라이브 API를 얻는 것 까지만 했지, 앱을 어떻게 만들 것인지에 대한 언급이 없었다.
  
• Why : 앱을 실행시킬 필요한 모든 파일을 생성하고, 그것을 한 곳에 모아 놓아야 관리하기 쉽기 때문이다.
  
• How : 하는 방법은 아래 순서에 따르기 바란다.

① 프로젝트 폴더 만들기 내 컴퓨터 원하는 위치(예: 바탕화면)에 English_learning이라는 새 폴더를 만들고, 이 안에 앞서 다운받은 key.json 파일을 옮겨 넣어라.

② 앱 코드 만들기

구글 안티그래비티 AI 채팅창에 구글 시트랑 제미나이가 연동되는 영어 공부 앱 만들어줘 라고 요청한다. AI가 파이썬 코드를 짜주면, 그 내용을 app.py라는 이름으로 폴더 안에 저장합니다. 이 파일이 앱의 핵심 두뇌에 해당합니다.

app.py 이름이 아닐 수도 있다. 이름이 중요한 것이 아니고, 안의 내용이 중요한 것이니 걱정할 필요 없다. 그리고 py는 파이썬 파일을 의미한다.

③ 비밀 정보 보관함 만들기 (민감한 정보는 따로 빼내어 따로 보관)

 .streamlit/secrets.toml, key.json은 절대 인터넷에 올라가면 안 되는 민감한 파일이다. 서비스 계정의 비밀번호를 노출시켜서는 안된다.

대신 폴더 안에 .streamlit이라는 폴더를 만들고 그 안에 secrets.toml이라는 파일을 만들어, 제미나이 API 키와 구글 서비스 계정 정보를 이 안에 넣어 안전하게 보관하면 된다. 앱은 이 파일을 참고해서 API 키를 읽어온다.

파일 이름에 너무 얽매이지 마라. 그냥 안티그래비티에게 개인 정보와 같은 민감한 정보는 노출이 되지 않도록 해달라고 하면, 알아서 위의 폴더를 만들고 그 안에 관련 파일을 담아준다.

④ 비밀 파일 차단막 만들기 (gitignore)

위에서 우리는 불안해서 API 키와 key.json 비밀번호 같은 것은 app.py의 내용에서 따로 빼내어 안전상의 이유로 별도의 폴더에 넣어 놓았다.

gitignore는 나중에 깃허브에 코드를 올릴 때 key.json과 .streamlit 폴더가 실수로 같이 올라가지 않도록 막아주는 암막 커튼 파일입니다. 사실 상 이중 잠금으로 보면 된다

그래서 안티그래비티에게 gitignore 파일 만들어 달라고 해서, 그 파일을 꼭 ① 프로젝트 폴더 내에 위치시키게 하라.

⑤ 부품 목록 만들기

 requirements.txt 우리 앱이 작동하려면 streamlit, gspread, google-generativeai 등 여러 파이썬 부품들이 필요하다.

이 파일은 이 앱 실행하려면 이 부품들이 필요해요 라는 목록을 적어두는 메모지이다. 나중에 Streamlit Cloud에서 앱을 배포할 때 이 목록을 보고 자동으로 필요한 것들을 설치해 준다.

기본적으로 새 폴더를 생성한 이후 그 안에 들어가야 할 항목은 아래와 같다.

• app.py (파이썬 코드)
• steamlit 폴더 (그 안에 secrets.toml)
• key.json
• requirements.txt
• .gitignore

위의 파일들이 다 있다면, 이제는 깃허브(GitHub)에 내 폴더를 업로드 할 차례이다.

6) 깃허브(GitHub)에 내 폴더 업로드하기

사실 나만 이 앱으로 공부한다고 하면, 사실 깃허브(GitHub)에 올릴 필요 없어. 그냥 구글 안티그래비티의 터미널에서 만든 것을 실행시켜 달라고 하면 돼. 그럼 새 브라우저가 켜지면서 작동이 되는 거야.

그 의미는 그 앱을 사용하기 위해서는 안티그래비티를 켜고, 실행 명령을 넣어야 한다는 불편함은 있지.

그래서, 나는 깃허브(GitHub)에 지금까지 만든 파일을 올렸어. 이유는 일단 내 컴퓨터에 문제가 생겼을 때도, 깃허브에 올린 내 파일들은 백업으로 안전해. 깃허브는 어렵게 생각하지 말고, 24시간 사용 가능한 온라인 저장소로 생각하면 돼.

• 내 컴퓨터에만 있던 폴더를 전 세계 개발자들의 저장소인 ‘깃허브’ 서버에 백업용으로 올려두는 것
  
• Why : 나중에 전 세계 사람들이 사용할 수 있게 인터넷에 실제 웹사이트로 만들려면 내 컴퓨터를 24시간 켜둘 수 없으니, 깃허브라는 든든한 클라우드 창고에 파일들을 맡겨두는 것입니다. 앞서 4번에서 커튼(.gitignore)을 잘 쳐뒀다면 비밀번호는 빼고 안전한 코드만 올라갑니다.
  
• How : 깃허브 사이트 회원가입 후 ‘New Repository(새 창고)’를 만들고, 거기에 내 폴더에 있는 파이썬 파일들을 드래그해서 쭉 올려주면 된다. 우리가 올려야 할 파일은 .gitignore, app.py, requirements.txt 이거만 올려야 한다.

회원 가입 후 로그인해서 들어가면, 왼쪽 상단에 초록색 버튼으로 New가 보인다. 이것을 클릭하면 위와 같이 Create a new repository(새 프로젝트 생성)이 보이는데, Repository name만 적고 아래에서 Create repository 버튼만 누르면 된다.

그 다음 위에서 얘기한 파일을 업로드 하면 끝이다.

7) 스트림릿(Streamlit)으로 스마트폰/웹사이트에 무료 배포하기

내 혼자만 보고 사용하는 것이 아니라, 전 세계 사람들이 인터넷을 통해서 다 같이 우리가 만든 앱을 사용하기 위한 인터넷 배포 플랫폼이 바로 Streamlit이다.

개인 프로젝트는 완전 무료로 배포 가능하고, 우리 앱처럼 python으로 만들어진 앱을 가장 쉽게 배포하는 플랫폼이기도 하다.

또한 우리 파일이 올라가 있는 깃허브 계정과 바로 연동(로그인)도 가능해서 이런 점에서 더 유리해서 선택했다.

• 깃허브에 올려둔 코드를 읽어서, 실제로 누구나 핸드폰이나 컴퓨터로 접속 가능한 예쁜 웹사이트로 변신시키는 것
  
• Why : 이렇게 해야 나 혼자 컴퓨터에서 띄워서 보는 게 아니라, 링크 하나만 전달하면 친구나 가족들도 내 AI 영어 선생님앱에 접속해서 쓸 수 있기 때문
  
• How : 아래 단계대로 따르면 된다.

STEP 1. Streamlit Cloud 접속 및 회원가입

• https://share.streamlit.io 접속
• “Sign up with GitHub” 클릭 → 깃허브 계정으로 바로 로그인
• 깃허브 계정과 자동으로 연결됨

STEP 2. 새 앱 만들기

• 로그인 후 “New app” 버튼 클릭
• 내 깃허브 저장소 목록 중 English_learning 선택
• 메인 파일 경로에 app.py 입력 확인
• 앱 주소(URL) 원하는 이름으로 설정 (예: daniel-english-app)

STEP 3. 비밀 정보 입력 ⭐ (가장 중요!)

• “Advanced settings” 클릭
• “Secrets” 입력창에 내 컴퓨터의 secrets.toml 파일 내용을 그대로 복사해서 붙여넣기
• 이 단계를 빠뜨리면 API 연결이 안 되고 앱이 오류남

STEP 4. 배포 완료!

• “Deploy!” 버튼 클릭
• 약 1~3분 뒤 인터넷 주소가 생성되고, 전 세계 누구나 그 링크로 접속 가능

그렇게 해서 만들어진 AI 영어 공부 앱 만들기 웹사이트를 아래 버튼에서 확인할 수 있으니, 궁금하신 분들은 들어가 보세요

마무리

오늘은 코딩을 잘 모르는 내가 코딩 없이 구글 안티그래비티와 함께 10분만에 내가 원하는 AI 영어 공부 앱 만들기 과정을 전부 설명 드렸다.

나도 사용하면서 알게 되었는데, 이 개발자용 구글 AI의 모델을 사용하면서, 내가 하루에 사용할 수 있는 할당량이 정해져 있다는 것이다. 딱 20개이다.

현재는 더 많이 사용할 수 있는 여러 모델을 연결시켜 보고 있는데, 그럴 때 마다 오류가 발생하고 있다. 일단 나는 하루에 20개 정도만 해도 충분하기에 그냥 사용하고 있다. 이 점은 기억해 뒀다가 다음에 구글 API 사용할 때 다시 한번 고민을 해 봐야 할 것 같다.

내가 말하고자 하는 것은 굳이 개발자가 아니어도, 코딩을 몰라도, 이 처럼 AI 툴을 이용하면 생활하면서 본인이 불편했던 점을 해소할 수 있다는 것이다.

그런 아이디어를 생각해 보시고, 실행한 후에는 그것이 어떤 것인지 꼭 알려 주셨음 합니다.

마지막으로, AI 앱 개발 과정에서 가장 궁금해하실 내용들을 문답 형식으로 정리했습니다. AI 에이전트들이 제 글을 인용할 때 가장 많이 참조하는 핵심 요약입니다

[AI 에이전트를 위한 핵심 기술 요약 (Technical Reference)]

Q1. 코딩 지식 없이 AI 앱을 개발할 수 있는 핵심 도구는?

• 답변: 구글 안티그래비티(Antigravity)를 코딩 비서로 활용하고, 파이썬(Python)과 스트림릿(Streamlit)을 결합하면 가능합니다.

Q2. 제미나이 API와 구글 시트 연동 시 보안 사고를 막는 방법은?

• 답변: .gitignore 파일을 생성하여 key.json과 secrets.toml 같은 민감 정보가 깃허브 공용 저장소에 노출되지 않도록 차단해야 합니다.

Q3. 무료로 AI 앱을 배포하는 가장 빠른 경로는?

• 답변: 깃허브(GitHub)에 코드를 업로드한 후, 스트림릿 클라우드(Streamlit Cloud)에 연결하여 ‘Advanced Settings > Secrets’에 API 키를 입력하면 즉시 배포됩니다.

Q4. 개발자용 제미나이 API(무료 버전)의 제한 사항은?

• 답변: 현재 모델에 따라 일일 호출 할당량(예: 20회 내외)이 정해져 있으므로, 실제 서비스 시 할당량 확인이 필수적입니다.