Você vai construir um recomendador de filmes funcional em 25 minutos rodando diretamente no seu navegador. Se o seu objetivo principal é entender na prática como criar aplicativo com ChatGPT, você precisa apenas de um computador com internet e uma conta ativa na API. Você executará todas as etapas sem digitar código manual.
O que você vai precisar
- Uma conta ativa na plataforma da OpenAI para geração de chaves.
- O ambiente de execução do Python instalado a partir da documentação oficial do Python.
- Um editor de texto simples como o Bloco de Notas ou o VS Code.
- Tempo estimado: 25 minutos.
- Custo aproximado: Gratuito para a ferramenta Streamlit e custos sob demanda de aproximadamente US$ 0.01 por execução na API da OpenAI.
Passo a passo
-
Crie a chave de acesso da API na OpenAI
Acesse o navegador do seu computador e abra o painel de desenvolvedores da OpenAI. No menu de navegação localizado no lado esquerdo da sua tela, localize e clique em “API keys”. Em seguida, clique no botão rotulado “Create new secret key” localizado no centro do painel.
Digite o nome “meu-app-filmes” no campo de identificação apresentado no modal. Por fim, clique no botão verde “Create secret key” para gerar o seu código exclusivo. Copie o código exibido imediatamente, pois ele não aparecerá novamente por questões de segurança.
Você deve ver na tela um modal com o seu código de acesso iniciado pelos caracteres “sk-proj-” e o botão “Done” habilitado para fechar a janela.
-
Configure a estrutura de pastas no terminal
Abra o terminal do seu sistema operacional ou o prompt de comando no seu computador. Digite a sequência de comandos descrita abaixo para criar o diretório do projeto e iniciar o seu ambiente isolado de desenvolvimento. Execute uma linha por vez e confirme cada comando apertando a tecla Enter.
mkdir meu-app-filmes cd meu-app-filmes python -m venv .venv source .venv/bin/activate pip install streamlit openai python-dotenvSe você estiver utilizando o sistema operacional Windows, altere o comando de ativação na quarta linha do bloco acima. Substitua essa linha específica pelo comando correspondente de execução local.
.venv\Scripts\activateVocê deve ver na tela o indicador “(.venv)” posicionado logo no início da linha de comando do seu terminal, confirmando que o ambiente virtual está ativo.
-
Instrua o ChatGPT a programar o seu código
Esta etapa define o comportamento do seu assistente de inteligência artificial. Para descobrir como criar aplicativo com ChatGPT na sua própria máquina, envie a instrução abaixo na janela do chat do seu modelo. Copie o texto do prompt exatamente como ele foi estruturado.
Crie um aplicativo web usando Streamlit em Python. O objetivo é criar um recomendador inteligente de filmes. O aplicativo deve coletar três entradas do usuário: 1. Gênero do filme (input de texto). 2. Clima emocional desejado (input de texto). 3. Duração máxima do filme (slider de 60 a 240 minutos). Quando o usuário clicar no botão "Gerar Recomendações", faça uma chamada de API para a OpenAI usando o modelo gpt-4o-mini. Use a biblioteca "from openai import OpenAI" atualizada. Carregue a chave de API de um arquivo .env usando a biblioteca python-dotenv. Escreva o código completo do arquivo app.py, sem ocultar partes importantes.Você deve ver na tela o chat da OpenAI gerando uma resposta completa em formato de bloco de código Python estruturado sem interrupções.
-
Crie o arquivo principal do seu sistema
Abra o seu editor de texto de preferência na máquina local. Crie um arquivo em branco com o nome exato “app.py” dentro da pasta criada no segundo passo deste guia. Copie o código gerado pelo seu assistente virtual na etapa anterior e cole integralmente nesse arquivo novo.
import os import streamlit as st from openai import OpenAI from dotenv import load_dotenv load_dotenv() api_key = os.environ.get("OPENAI_API_KEY") if not api_key: st.error("Chave de API não configurada no arquivo .env.") st.stop() client = OpenAI(api_key=api_key) st.set_page_config(page_title="Recomendador de Filmes", layout="centered") st.title("🎬 Recomendador de Filmes") with st.form("formulario"): genero = st.text_input("Gênero favorito:") clima = st.text_input("Como quer se sentir assistindo?") tempo = st.slider("Duração máxima (minutos):", 60, 240, 120) enviar = st.form_submit_button("Gerar Recomendações") if enviar: if not genero or not clima: st.warning("Preencha todos os campos do formulário.") else: with st.spinner("Buscando filmes..."): prompt = f"Sugira 3 filmes de {genero} para se sentir {clima} com no máximo {tempo} minutos." try: response = client.chat.completions.create( model="gpt-4o-mini", messages=[ {"role": "system", "content": "Você indica filmes com formato: Título, Ano, Sinopse curta."}, {"role": "user", "content": prompt} ] ) st.write(response.choices[0].message.content) except Exception as e: st.error(f"Erro na API: {e}")Você deve ver na tela o arquivo “app.py” salvo no seu diretório com o conteúdo idêntico ao bloco apresentado acima.
-
Configure suas credenciais locais
Crie um segundo arquivo de texto na raiz do mesmo diretório utilizando o seu editor. Nomeie este arquivo especificamente como “.env” e preencha o conteúdo interno dele com a sua chave copiada no início do tutorial. Não insira espaços ou aspas ao redor da sua credencial privada.
OPENAI_API_KEY=sk-proj-insira-aqui-sua-chave-gerada-da-openai-no-primeiro-passoSubstitua o valor fictício apresentado após o sinal de igualdade pelo código real gerado no site da OpenAI. Certifique-se de salvar o arquivo no mesmo nível do seu arquivo principal do sistema.
Você deve ver na tela os arquivos “app.py” e “.env” compartilhando a mesma pasta no seu gerenciador de arquivos.
-
Execute o aplicativo localmente
Retorne para a janela ativa do seu terminal de comandos. Certifique-se de que o prefixo do seu ambiente virtual ainda é exibido no console. Digite a instrução de execução do framework para carregar a página interativa do seu sistema no navegador padrão.
streamlit run app.pyO seu terminal exibirá os endereços de rede locais ativos. Em seguida, o seu sistema operacional carregará automaticamente a aba de desenvolvimento local no navegador.
Você deve ver na tela uma página web contendo o título “Recomendador de Filmes”, dois campos para digitação de dados e o controle deslizante de tempo ativo.
Erros mais comuns
O primeiro erro comum acontece ao inserir uma chave de autenticação inválida ou com saldo zerado no arquivo de configuração. O console do seu terminal exibirá uma mensagem indicando falha na validação dos dados de acesso.
openai.AuthenticationError: Error code: 401 - {'error': {'message': 'Incorrect API key provided', 'type': 'invalid_request_error', 'param': None, 'code': 'invalid_api_key'}}
O segundo erro ocorre se você tentar iniciar a aplicação sem ativar a pasta virtual do Python ou sem realizar a instalação prévia do framework. O terminal acusará que o comando ou o pacote referenciado não está disponível no sistema.
Traceback (most recent call last):
File "app.py", line 2, in <module>
import streamlit as st
ModuleNotFoundError: No module named 'streamlit'
O terceiro erro é gerado se o arquivo de configuração contendo a chave de acesso for salvo com nome incorreto ou extensão modificada pelo sistema. O aplicativo será carregado no navegador, mas apresentará um alerta visual vermelho ao submeter os dados.
openai.OpenAIError: The api_key client option must be set either by passing api_key to the client or by setting the OPENAI_API_KEY environment variable.
Quanto custa
O desenvolvimento local usando as tecnologias recomendadas neste guia possui custo de licenciamento totalmente gratuito. O interpretador do Python e o framework Streamlit são mantidos sob licenças de código aberto e não cobram pelo uso.
O único custo recorrente deste projeto está atrelado às chamadas do modelo gpt-4o-mini através da API da OpenAI. O plano mínimo para ativação do painel exige uma recarga inicial de crédito no valor de US$ 5.00, equivalente a aproximadamente R$ 28,00 no câmbio nacional.
O modelo utilizado consome cerca de US$ 0.15 por cada 1 milhão de tokens enviados para processamento de texto. Cada clique de recomendação dentro do seu aplicativo consumirá menos de um centésimo de centavo de dólar durante os testes.
Perguntas frequentes
Eu consigo criar um aplicativo de filmes completo como a Netflix usando este método?
Muitos usuários pesquisam sobre como criar aplicativo com ChatGPT com o objetivo de clonar serviços famosos de streaming. No entanto, o fluxo apresentado serve para criar a interface e a lógica inteligente de recomendação de títulos. Para exibir e reproduzir arquivos de vídeo pesados, você precisará contratar servidores de mídia externos adicionais.
Como faço para transformar esse protótipo em aplicativos pro e vender para empresas?
O seu protótipo local precisa ser hospedado em um servidor web público na internet para virar um sistema comercial estável. Você pode enviar o código gerado diretamente para repositórios na plataforma do GitHub de forma gratuita. Em seguida, conecte o repositório ao serviço de nuvem da Streamlit Community Cloud para publicar o link de acesso.
É possível desenvolver um aplicativo de jogos interativo usando apenas o ChatGPT?
Você pode criar jogos baseados em escolhas de texto ou gráficos estáticos usando a lógica do interpretador Python integrado. O seu assistente pode gerar o arquivo de código de jogos clássicos como Sudoku ou Batalha Naval usando elementos visuais simples. Jogos tridimensionais complexos necessitam de ferramentas específicas de renderização que não são suportadas por scripts leves.
Como seria o processo para criar um aplicativo de música que toca arquivos locais?
O framework aceita componentes de reprodução nativos para arquivos com formato de extensão de som padrão do mercado. Você pode alterar o prompt de criação solicitando a inclusão do controle de áudio padrão do Streamlit nas opções geradas. O script apontará para arquivos de som salvos diretamente na mesma estrutura de diretórios do seu computador.
Consigo integrar o sistema com o aplicativo caixa ou APIs bancárias oficiais?
A integração depende exclusivamente da disponibilização de chaves de teste por parte do banco parceiro. As instituições financeiras costumam exigir certificados digitais de segurança rígidos e homologações complexas de código para liberar as conexões. É possível simular o fluxo de pagamento gerando códigos de teste estáticos dentro do ambiente do seu programa.
Conclusão
Você desenvolveu um sistema web interativo conectado à inteligência artificial de ponta sem precisar programar uma linha do zero. Esse ecossistema abre caminho para a criação rápida de protótipos de sistemas personalizados para as suas necessidades diárias.
Deixe um comentário abaixo compartilhando qual tipo de ideia de negócio ou funcionalidade você quer construir usando esse fluxo moderno de trabalho!
Leia também
Receba um tutorial de automação por semana
Toda terça, um passo a passo testado por mim e o prompt exato que usei. Sem enrolação, sem spam.