Como rodar Python no iPhone: configuração em 2026 com Pythonista e Git

A resposta mais simples para como rodar Python no iPhone é instalar um app que traga seu próprio interpretador Python, porque o iOS não tem Python nem terminal integrados. O Pythonista 3 é a opção mais conhecida, por um pagamento único de US$ 9,99 na App Store dos EUA (em novembro de 2026), e existem alternativas gratuitas ou freemium. Este guia cobre a configuração, os pacotes, os Atalhos, a sincronização com Git pelo Working Copy e uma nota rápida sobre Android.

Você não precisa fazer jailbreak no celular nem ter um Mac. Tudo abaixo roda em apps normais da App Store.

O que você precisa antes de começar

A configuração é leve. Reúna estes itens antes de começar:

• Um iPhone ou iPad com uma versão do iOS razoavelmente recente. Confira na página de cada app na App Store o requisito mínimo.
• Um app de Python. Este guia usa o Pythonista 3, um app pago, sem assinatura.
• Cerca de 900 MB de espaço livre. A página do Pythonista mostra um download de 894,3 MB, principalmente porque ele vem com pacotes científicos.
• Opcional: o Working Copy e uma conta no GitHub, GitLab ou similar, se você quiser seus scripts sob controle de versão.
• Opcional: o app gratuito GitHub para ler issues e revisar pull requests em qualquer lugar.

Você pode ver mais apps de programação e terminal na nossa categoria Ferramentas para desenvolvedores.

Por que a documentação oficial do Python diz que não dá para fazer

Se você pesquisar, vai encontrar a documentação oficial do Python para iOS. Ela explica que o iOS não tem console para rodar um executável python ou REPL. Isso é verdade, mas descreve desenvolvedores embutindo o CPython no próprio app com o Xcode.

Isso não significa que você não possa escrever e rodar scripts no celular. Apps como o Pythonista fazem exatamente essa incorporação por você e ainda acrescentam um editor e um console.

Escolhendo um app de Python para iPhone

O Pythonista é a escolha do editor neste guia, principalmente pela integração profunda com o iOS e pelo preço único. Não é o único caminho, e ele ficou datado, então compare antes de comprar.

App	Modelo de preço	Versão do Python	Pacotes	Observações
Pythonista 3	Pagamento único de US$ 9,99 (em novembro de 2026)	3.10	numpy, pandas, matplotlib, requests, Pillow e mais; extras em Python puro via StaSh	Módulos iOS robustos, última atualização em abril de 2023
Juno	Edição gratuita; para rodar código é preciso uma compra Pro única após um período de teste	3.13	Mais de 150 incluídos; a maioria dos pacotes do PyPI em Python puro	Exige iOS 17 ou superior; notebooks estilo Jupyter
Pyto	Freemium	3.10, segundo a página do app	Mais de 100 incluídos, segundo a página do app	A página menciona um compilador C/C++; detalhes não confirmados para 2026
a-Shell	Grátis	Confira na página do app	Confira na página do app	Um terminal local estilo Unix que inclui Python

O guia mais recente entre os mais bem posicionados nas buscas sobre este tema vem do desenvolvedor do Juno, então leia sabendo que ele promove o próprio app. Mesmo assim, ele tem um bom argumento: o Juno roda um Python mais novo que o do Pythonista. Se você precisa de recursos do Python 3.11 ou posterior, o Juno é a aposta mais segura.

Se você quer scripts offline que mexam em fotos, área de transferência ou localização, o Pythonista continua muito capaz. Sua nota na App Store é 4,4, com cerca de 1.500 avaliações.

Como rodar Python no iPhone com o Pythonista 3

Estes passos levam você da instalação a um script funcionando em poucos minutos.

1. Compre e instale o Pythonista 3 pela página na App Store.
2. Abra o app e deixe-o terminar de configurar os arquivos incluídos.
3. Toque no botão de mais no navegador de arquivos para criar um novo arquivo.
4. Escolha um script vazio e dê um nome, como hello.py.
5. Digite uma linha como print("hello from my phone").
6. Toque no botão Run, no topo do editor.
7. Deslize ou toque para abrir o console e ler a saída.

Experimente o console interativo

O console também funciona como REPL. Você pode digitar linhas avulsas, testar uma função ou inspecionar uma variável depois que um script termina.

Essa é a forma mais rápida de verificar se um módulo está disponível. Digite import numpy, pressione return e veja se dá erro.

Abra os exemplos incluídos

O Pythonista vem com uma pasta Examples. Ela inclui scripts de desenho, interfaces de usuário, jogos e recursos do iOS.

Rode alguns antes de escrever os seus. Lê-los é o caminho mais rápido para aprender os módulos específicos do Pythonista, já que a documentação offline integrada explica cada um.

Adicionando pacotes e os limites que você vai encontrar

O Pythonista inclui de fábrica um conjunto de pacotes populares de terceiros, então muitos scripts simplesmente funcionam. A lista inclui requests, numpy, matplotlib, pandas e Pillow, entre outros.

Instalando pacotes extras em Python puro

Não há um botão oficial de pip. O shell StaSh, feito pela comunidade, roda dentro do Pythonista e oferece um comando pip.

1. Visite a página do projeto StaSh e siga as instruções de instalação atuais.
2. Execute o script instalador dentro do Pythonista.
3. Abra o StaSh pelo navegador de arquivos.
4. Digite pip install seguido do nome do pacote.

Isso funciona para pacotes escritos só em Python. A própria página do Pythonista diz que ele não foi projetado para módulos escritos em C ou C++, e em geral eles não podem ser instalados.

O que não vai rodar

Conheça estes limites antes de planejar um projeto:

• Nenhum pacote compilado além dos que vêm com o app. Qualquer coisa que precise de uma extensão em C não incluída está fora.
• Nada de PyTorch, TensorFlow ou JAX. O guia do Juno observa que eles não estão disponíveis no iOS, seja qual for o app.
• Sem terminal de verdade e sem servidores de longa duração em segundo plano. O iOS suspende os apps que você deixa.
• Apenas Python 3.10. Sintaxe nova e recursos da biblioteca padrão do 3.11 em diante vão falhar.

Automatizando scripts com Atalhos e Siri

O ponto forte do Pythonista é como ele alcança o iOS. Os scripts podem ler dados de sensores e localização, fotos, contatos, lembretes e a área de transferência.

Ele também adiciona uma extensão da folha de compartilhamento, para você enviar texto ou um arquivo de outro app para um script. O teclado PyKeys, adicionado na versão 3.3, permite rodar scripts a partir de um teclado do sistema.

Rode um script pelos Atalhos

A versão 3.4 adicionou ações personalizadas nos Atalhos para rodar scripts e acessar arquivos da biblioteca.

1. Abra o app Atalhos e crie um novo atalho.
2. Procure Pythonista na lista de ações.
3. Adicione a ação que roda um script e escolha seu arquivo.
4. Dê um nome ao atalho para poder acioná-lo por voz com a Siri.
5. Se quiser, adicione-o a uma automação pessoal para um horário do dia.

Use o esquema de URL como alternativa

Guias mais antigos iniciam scripts com uma URL como pythonista://script.py?action=run. Essa abordagem ainda ajuda quando outro app consegue abrir URLs mas não tem uma ação nos Atalhos. Teste na sua configuração, já que esses guias têm vários anos.

Sincronizando scripts com Git pelo Working Copy

Nenhum guia do ranking que encontramos explica isso, e o manual do próprio Working Copy não menciona o Pythonista. O fluxo depende de dois recursos: o Working Copy expõe os repositórios clonados no app Arquivos, e o Pythonista 3.3 adicionou a abertura de pastas externas pelo seletor de arquivos do sistema.

Configure o repositório

1. Instale o Working Copy, que é gratuito com compras dentro do app.
2. Entre no seu host Git dentro do Working Copy.
3. Toque para clonar o repositório que guarda seus scripts.

Abra a pasta no Pythonista

1. No navegador de arquivos do Pythonista, escolha a opção de abrir uma pasta externa.
2. No seletor de arquivos, vá até Working Copy na lista de locais.
3. Selecione a pasta do seu repositório.
4. Edite e rode scripts direto dessa pasta.

Faça commit e push

1. Volte ao Working Copy e abra o repositório.
2. Revise os arquivos alterados.
3. Escreva uma mensagem de commit e faça o commit.
4. Faça push para o seu remoto.

O push exige o desbloqueio Pro. A versão gratuita também limita você a cinco repositórios. Um teste de 10 dias permite experimentar o ciclo completo antes.

A licença funciona de um jeito diferente da maioria dos apps. Você mantém os recursos pelos quais pagou, mas recursos adicionados mais de 12 meses após a compra exigem um novo desbloqueio. O Working Copy também tem ações nos Atalhos para a maioria das operações, então você pode encadear um pull, uma execução no Pythonista e um commit.

O app GitHub funciona ao lado disso, não no lugar. Ele cuida de notificações, issues e revisões de pull requests, mas não clona repositórios nem roda código.

Problemas comuns e soluções

• ModuleNotFoundError para um pacote. Veja se ele é Python puro. Se for, instale com o pip do StaSh. Se precisar de código C, procure uma alternativa incluída ou tire a tarefa do celular.
• Erros de sintaxe em código que funciona no seu notebook. Seu notebook provavelmente roda um Python mais novo. Evite recursos introduzidos depois do 3.10, como a sintaxe mais nova de grupos de exceções.
• O script para quando você troca de app. O iOS suspende apps em segundo plano. Mantenha o Pythonista em primeiro plano ou divida a tarefa em execuções curtas acionadas pelos Atalhos.
• A pasta do Working Copy não aparece no seletor. Abra o Working Copy uma vez para que seu local no Arquivos seja registrado e tente de novo.
• O push falha no Working Copy. Você provavelmente precisa do Pro, ou o teste acabou.
• Um Atalho não encontra o script. Escolha o arquivo de novo na ação depois de renomeá-lo ou movê-lo.

Rodando Python no Android com o Termux

O Android é mais aberto, então você tem um terminal de verdade. O Termux é uma linha de comando Linux gratuita, com gerenciador de pacotes próprio e sem precisar de root.

1. Instale o Termux pela fonte que o projeto Termux recomenda atualmente.
2. Abra-o e execute pkg update.
3. Execute pkg install python.
4. Digite python para iniciar o interpretador, ou pip install para adicionar pacotes.

Como o Termux é um ambiente completo, você pode usar git, rodar scripts pela linha de comando e usar muitos pacotes que o Pythonista não suporta.

Outros caminhos quando o celular não basta

Às vezes a resposta certa é rodar o código em outro lugar e usar o celular como uma janela.

• Notebooks na nuvem. O Google Colab roda no Safari e oferece um Python completo com bibliotecas pesadas, desde que você esteja online.
• SSH para uma máquina de verdade. O Termius se conecta a um servidor, computador ou Raspberry Pi, onde qualquer versão do Python e qualquer pacote funciona.
• Criar um app de verdade. O Briefcase, do BeeWare, empacota código Python como um app iOS nativo. Esse caminho exige o Xcode em um Mac.

Apps que facilitam

• Pythonista 3: a principal ferramenta para scripts no aparelho, com integração profunda ao iOS. Aceite que ele parou no Python 3.10.
• Working Copy: o cliente Git que torna possível o controle de versão no iPhone. Reserve um valor para o Pro se você faz push.
• GitHub: útil para triar issues e revisar pull requests entre as sessões de código.
• Termius: a opção de reserva quando você precisa de mais poder do que o iOS permite.
• Termux: o equivalente para Android, com um shell de verdade.

Se você ainda está aprendendo a linguagem, cursos estruturados da nossa categoria Educação, como o Brilliant, podem acompanhar sua prática no celular. Quando seus primeiros scripts rodarem, você já saberá como rodar Python no iPhone o suficiente para começar a automatizar tarefas do dia a dia.