Início rápido — Python

Publique uma aplicação Python funcional em menos de 2 minutos.

Nota: Este quickstart cobre apenas projetos com origem em Repositório GitHub.

Passo 1 — Crie sua aplicação

mkdir hello-zenifra-python
cd hello-zenifra-python
python -m venv .venv
source .venv/bin/activate
pip install fastapi uvicorn

Crie main.py:

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def root():
    return {"message": "Hello from Zenifra!", "runtime": "python"}

@app.get("/health")
async def health():
    return {"status": "ok"}

Crie requirements.txt com as dependências:

fastapi
uvicorn

Importante: requirements.txt é obrigatório para projetos Python na Zenifra.

Passo 2 — Publique no GitHub

Crie um repositório no GitHub e envie o código:

git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/your-username/hello-zenifra-python.git
git push -u origin main

Passo 3 — Crie o projeto na Zenifra

No console, escolha Origem de Projeto como Repositório GitHub.
Selecione o repositório e a branch main.
No campo de runtime, selecione Python.
No campo Porta, informe 3000.
Em start, use uvicorn main:app --host 0.0.0.0 --port 3000.
Se quiser atualização automática por push, habilite auto-deploy na criação.
Clique em Criar Projeto.

Sua aplicação ficará disponível em *.clients.zenifra.com.

Passo 4 — Valide o deploy

Abra a URL pública e teste /health. Se a aplicação não responder, revise porta, comando de start e logs.

Publicando uma aplicação Flask

Para Flask, a configuração é praticamente idêntica:

# app.py
from flask import Flask
app = Flask(__name__)

@app.route("/")
def hello():
    return {"message": "Hello from Zenifra with Flask!"}

# requirements.txt
flask
gunicorn

Observação sobre runtime

Na Zenifra, o runtime é escolhido no momento da criação do projeto. Para mais detalhes sobre instalação de dependências, comandos e limitações, consulte a página de Runtimes.