@aiuby-ia/cli 0.3.0 → 0.5.0

package/README.md

@@ -2,24 +2,26 @@
 
 Linha de comando e templates de partida do **AIUBY Compute**.
 
-> **Estado: prévia (0.3.0).** A CLI autentica, copia templates, cadastra aplicações e
+> **Estado: prévia (0.4.0).** A CLI autentica, copia templates, cadastra aplicações e
 > revisões a partir do `aiuby.toml`, lê o catálogo de hardware e mostra o plano de
 > implantação. **Implantar funciona só em organizações com a prévia do runtime habilitada
 > pela AIUBY**: CPU no Google Cloud, até 1 vCPU e 1 GB, 1 réplica, endereço público e prazo
-> (a aplicação para sozinha). Nas demais, o pedido é recusado com os motivos. Logs, escala,
-> volumes, segredos e GPU ainda não existem.
+> (a aplicação para sozinha), com `aiuby logs` para ver a saída. Nas demais, o pedido é
+> recusado com os motivos. Escala, volumes, segredos e GPU ainda não existem.
 
 ## Instalação
 
-Precisa de Node.js 20 ou mais novo. O pacote é distribuído pelo site da AIUBY:
+Precisa de Node.js 20 ou mais novo.
 
 ```bash
-npm install -g https://aiuby.com/cli/aiuby-cli-latest.tgz
+npm install -g @aiuby-ia/cli
 aiuby --version
 ```
 
-Para fixar uma versão, troque `latest` pelo número (por exemplo `aiuby-cli-0.3.0.tgz`).
-Para atualizar, rode o mesmo comando de novo. Para remover: `npm uninstall -g @aiuby-ia/cli`.
+Sem acesso ao registro do npm, o mesmo pacote está no site da AIUBY:
+`npm install -g https://aiuby.com/cli/aiuby-cli-latest.tgz`.
+
+Para atualizar, rode o comando de instalação de novo. Para remover: `npm uninstall -g @aiuby-ia/cli`.
 
 ## Primeiros passos
 
@@ -51,6 +53,7 @@ aiuby apps create            # cadastra; não implanta
 aiuby apps update            # depois de mudar o aiuby.toml: nova revisão
 aiuby deploy --dry-run minha-api
 aiuby deploy minha-api       # só com a prévia do runtime; pede o escopo "Implantar no Compute"
+aiuby logs minha-api
 aiuby stop minha-api
 ```
 
@@ -70,6 +73,8 @@ Em automação, defina `AIUBY_TOKEN` no ambiente em vez de usar `login`.
 | [`templates/fastapi-http`](templates/fastapi-http) | API HTTP em Python com FastAPI, em CPU |
 | [`templates/vllm-openai`](templates/vllm-openai) | Inferência com vLLM e API compatível com OpenAI, em GPU |
 | [`templates/langgraph-agent`](templates/langgraph-agent) | Agente com LangGraph atrás de uma API HTTP, em CPU |
+| [`templates/hf-stable-diffusion`](templates/hf-stable-diffusion) | Geração de imagem com um modelo de difusão do Hugging Face, em GPU |
+| [`templates/yolo-detect`](templates/yolo-detect) | Detecção de objetos com YOLO (Ultralytics, AGPL-3.0), em GPU |
 
 São pontos de partida de código. Ainda não foram executados num runtime da AIUBY.
 

package/dist/aiuby.mjs

@@ -20482,6 +20482,9 @@ var APP_SLUG = /^[a-z][a-z0-9-]{1,38}[a-z0-9]$/;
 var MAX_REPLICAS = 100;
 var CONTROL_CHARS = /[\u0000-\u001f\u007f-\u009f]/;
 var noControl = (v) => !CONTROL_CHARS.test(v);
+var ENV_NAME = /^[A-Z_][A-Z0-9_]{0,63}$/;
+var RESERVED_ENV = /* @__PURE__ */ new Set(["PORT", "K_SERVICE", "K_REVISION", "K_CONFIGURATION"]);
+var MAX_ENV_VARS = 50;
 var IMAGE_REF = /^(?!.*\/\/)[A-Za-z0-9][A-Za-z0-9._\-/:@]*$/;
 var HardwareRequest = external_exports.object({
   /** `any`: o planejador escolhe entre os provedores habilitados. */
@@ -20497,6 +20500,11 @@ var AppConfig = external_exports.object({
   image: external_exports.string().min(1).max(300).regex(IMAGE_REF, "image precisa ser uma refer\xEAncia de imagem de container, sem espa\xE7os").nullable().default(null),
   entrypoint: external_exports.string().min(1).max(300).refine(noControl, "entrypoint n\xE3o aceita caracteres de controle").nullable().default(null),
   port: external_exports.number().int().min(1).max(65535).default(8080),
+  /**
+   * Variáveis de ambiente da aplicação. Ficam na configuração, visíveis a quem vê a
+   * aplicação: servem para ajuste, NÃO para segredo (senha, chave, token).
+   */
+  env: external_exports.record(external_exports.string().regex(ENV_NAME, "nome de vari\xE1vel: mai\xFAsculas, d\xEDgitos e sublinhado").refine((name) => !RESERVED_ENV.has(name), "nome reservado pela plataforma"), external_exports.string().max(2e3).refine(noControl, "valor n\xE3o aceita caracteres de controle")).refine((env) => Object.keys(env).length <= MAX_ENV_VARS, `no m\xE1ximo ${MAX_ENV_VARS} vari\xE1veis`).default({}),
   hardware: HardwareRequest,
   scaling: external_exports.object({
     minReplicas: external_exports.number().int().min(0).max(MAX_REPLICAS).default(0),
@@ -20620,17 +20628,20 @@ async function appsStatus(io, args) {
     io.out(`Hardware: ${app.hardwareLabel ?? "-"}`);
     io.out(`Regi\xE3o:   ${app.region ?? "a definir"}`);
     io.out("");
-    io.out(plan.deployable ? `Plano: implant\xE1vel${plan.preview ? " (pr\xE9via do runtime: CPU, 1 r\xE9plica, com prazo)" : ""}.` : "Plano: n\xE3o implant\xE1vel hoje.");
+    io.out(plan.deployable ? `Plano: implant\xE1vel${plan.preview ? " (pr\xE9via do runtime, com prazo, sem cobran\xE7a)" : ""}.` : "Plano: n\xE3o implant\xE1vel hoje.");
+    if (plan.paid) io.out(paidLine(plan.paid));
     for (const r of plan.reasons) io.out(`  - ${r.message}`);
   });
 }
+var brl = (microBrl) => (microBrl / 1e6).toLocaleString("pt-BR", { style: "currency", currency: "BRL" });
+var paidLine = (paid) => `Tamanho ${paid.sizeName}${paid.priceMicroBrlPerHour !== null ? `: ${brl(paid.priceMicroBrlPerHour)} por hora em uso` : ""}.`;
 var fetchDeployment = (io, stored, slug) => apiGet(stored, `/api/platform/compute/apps/${encodeURIComponent(slug)}/deployments`, io.fetcher);
 var when = (iso) => new Date(iso).toLocaleString("pt-BR", { dateStyle: "short", timeStyle: "short" });
 function printDeployment(io, d) {
   io.out(`Implanta\xE7\xE3o: ${DEPLOYMENT_STATUS_LABEL[d.status].toLowerCase()}, revis\xE3o r${d.revision}, ${d.region}`);
   if (d.url) io.out(`Endere\xE7o: ${d.url}`);
   if (d.error) io.out(`Detalhe:  ${d.error}`);
-  if (d.status === "running" || d.status === "deploying") io.out(`Prazo:    para sozinha em ${when(d.expiresAt)}`);
+  if (d.status === "running" || d.status === "deploying") io.out(d.billing === "paid" ? "Cobran\xE7a: do saldo pr\xE9-pago, pelo tempo em uso. Fica no ar at\xE9 parar, o saldo acabar ou o teto do workspace ser atingido." : `Prazo:    para sozinha em ${when(d.expiresAt)}`);
 }
 var DEPLOY_HINT = 'A chave precisa do escopo "Implantar no Compute".';
 var WAIT_STEP_MS = 3e3;
@@ -20647,6 +20658,7 @@ async function deploy(io, args) {
     const plan = await fetchPlan(io, stored, slug);
     emit(io, plan, () => {
       io.out(plan.deployable ? `Plano de ${slug}: implant\xE1vel.` : `Plano de ${slug}: n\xE3o implant\xE1vel hoje.`);
+      if (plan.paid) io.out(paidLine(plan.paid));
       for (const r of plan.reasons) io.out(`  - ${r.message}`);
       io.out("");
       io.out("Simula\xE7\xE3o: nada foi criado nem cobrado.");
@@ -20672,6 +20684,39 @@ async function stop(io, args) {
   await apiPost(requireLogin(), `/api/platform/compute/apps/${encodeURIComponent(slug)}/deployments/stop`, void 0, io.fetcher).catch(scopeHint(DEPLOY_HINT));
   emit(io, { ok: true, slug }, () => io.out(`${slug} parada: o servi\xE7o foi apagado e o endere\xE7o n\xE3o responde mais.`));
 }
+async function logs(io, args) {
+  const slug = args.find((a, i) => !a.startsWith("--") && args[i - 1] !== "--limit");
+  if (!slug) throw new CliError("Uso: aiuby logs [--limit N] <identificador>", EXIT.usage);
+  const flag = args.indexOf("--limit");
+  const limit = flag >= 0 ? Number(args[flag + 1]) : 100;
+  if (!Number.isInteger(limit) || limit < 1 || limit > 200) throw new CliError("--limit precisa ser um n\xFAmero de 1 a 200.", EXIT.usage);
+  const data = await apiGet(requireLogin(), `/api/platform/compute/apps/${encodeURIComponent(slug)}/logs?limit=${limit}`, io.fetcher);
+  emit(io, data, () => {
+    if (data.lines.length === 0) return io.out(`Nenhuma linha de log desde a implanta\xE7\xE3o (revis\xE3o r${data.deployment.revision}).`);
+    for (const line of [...data.lines].reverse()) io.out(`${line.time.replace("T", " ").slice(0, 19)} ${line.severity.padEnd(7)} ${line.text}`);
+  });
+}
+async function billing(io) {
+  const data = await apiGet(requireLogin(), "/api/platform/compute/billing", io.fetcher);
+  emit(io, data, () => {
+    if (!data.enabled) io.out("A implanta\xE7\xE3o paga n\xE3o est\xE1 habilitada nesta organiza\xE7\xE3o.");
+    io.out(`Saldo pr\xE9-pago:   ${data.mode === "prepaid" && data.availableMicroBrl !== null ? brl(data.availableMicroBrl) : "-"}`);
+    io.out(`Compute no m\xEAs:   ${brl(data.monthSpendMicroBrl)}`);
+    io.out(`Teto do workspace: ${data.budgetMicroBrl === null ? "n\xE3o definido (dono ou admin define na tela do Compute)" : brl(data.budgetMicroBrl)}`);
+    io.out("");
+    table(io, ["TAMANHO", "VCPU", "MEM\xD3RIA", "PRE\xC7O POR HORA EM USO"], data.sizes.map((s) => [s.name, String(s.cpu), `${s.memoryMb} MB`, s.priceMicroBrlPerHour === null ? "-" : brl(s.priceMicroBrlPerHour)]));
+  });
+}
+async function usage(io, args) {
+  const flag = args.indexOf("--limit");
+  const limit = flag >= 0 ? Number(args[flag + 1]) : 50;
+  if (!Number.isInteger(limit) || limit < 1 || limit > 200) throw new CliError("--limit precisa ser um n\xFAmero de 1 a 200.", EXIT.usage);
+  const data = await apiGet(requireLogin(), `/api/platform/compute/usage?limit=${limit}`, io.fetcher);
+  emit(io, data, () => {
+    if (data.usage.length === 0) return io.out("Nenhum uso cobrado neste workspace.");
+    table(io, ["APLICA\xC7\xC3O", "AT\xC9", "EM USO", "SA\xCDDA", "VALOR"], data.usage.map((u) => [u.appSlug, when(u.periodEnd), `${Math.round(u.billableSeconds / 60)} min`, `${(u.egressBytes / 1024 ** 2).toFixed(1)} MB`, brl(u.billedMicroBrl)]));
+  });
+}
 async function capacityList(io, args) {
   const flag = args.indexOf("--provider");
   const provider = flag >= 0 ? args[flag + 1] : void 0;
@@ -20791,7 +20836,7 @@ var notYet = (command) => async () => {
 };
 
 // src/main.ts
-var VERSION = "0.3.0";
+var VERSION = "0.5.0";
 var HELP = `aiuby ${VERSION} \u2014 linha de comando do AIUBY Compute
 
 Uso: aiuby <comando> [op\xE7\xF5es]
@@ -20809,12 +20854,15 @@ Dispon\xEDveis hoje:
   capacity list [--provider gcp|aws]  Cat\xE1logo de hardware (refer\xEAncia, n\xE3o verificado)
   config validate [arquivo]        Valida um aiuby.toml local
   deploy --dry-run <identificador> Mostra o plano, sem criar nada
-  deploy [--no-wait] <identificador>  Implanta a revis\xE3o atual (s\xF3 em organiza\xE7\xE3o com a pr\xE9via do runtime)
+  deploy [--no-wait] <identificador>  Implanta a revis\xE3o atual (o plano diz se a organiza\xE7\xE3o pode)
   stop <identificador>             Para a implanta\xE7\xE3o e apaga o servi\xE7o
+  logs [--limit N] <identificador> \xDAltimas linhas de log da implanta\xE7\xE3o mais recente
+  billing                          Saldo, teto e gasto do m\xEAs de Compute, e os tamanhos com pre\xE7o
+  usage [--limit N]                Extrato do Compute no workspace
   doctor                           Confere ambiente, credencial e API
 
 Ainda n\xE3o dispon\xEDveis:
-  run, logs, scale, rollback, volumes, secrets, domains
+  run, scale, rollback, volumes, secrets, domains
 
 Op\xE7\xF5es gerais:
   --json       Sa\xEDda em JSON
@@ -20823,7 +20871,7 @@ Op\xE7\xF5es gerais:
 
 Ambiente: AIUBY_TOKEN, AIUBY_API_URL, AIUBY_CONFIG_DIR
 C\xF3digos de sa\xEDda: 0 ok \xB7 1 erro \xB7 2 uso incorreto \xB7 3 n\xE3o autenticado \xB7 4 recusado \xB7 5 configura\xE7\xE3o inv\xE1lida`;
-var PLANNED = ["run", "logs", "scale", "rollback", "volumes", "secrets", "domains"];
+var PLANNED = ["run", "scale", "rollback", "volumes", "secrets", "domains"];
 var ROUTES = {
   login,
   logout,
@@ -20838,6 +20886,9 @@ var ROUTES = {
   "config validate": configValidate,
   deploy,
   stop,
+  logs,
+  billing,
+  usage,
   doctor
 };
 async function run(argv, io) {

package/docs/api.md

@@ -74,10 +74,15 @@ Cadastra a aplicação com a primeira revisão. Nada é implantado. Responde `20
 ```json
 { "name": "Minha API", "slug": "minha-api",
   "config": { "runtime": "container", "image": "REGISTRO/minha-api:1", "port": 8080,
+    "env": { "LOG_LEVEL": "info" },
     "hardware": { "provider": "any", "cpu": 1, "memoryMb": 512 },
     "scaling": { "minReplicas": 0, "maxReplicas": 2 } } }
 ```
 
+`config.env` são variáveis de ambiente (até 50; nomes em maiúsculas, dígitos e sublinhado;
+`PORT` e os nomes `K_*` são da plataforma). Elas ficam visíveis a quem vê a aplicação: não
+use para senha, chave ou token.
+
 Regras: `slug` com 3 a 40 caracteres (minúsculas, dígitos e hífen, começando por letra),
 único no workspace; `runtime` `container` exige `image`; campos desconhecidos são recusados.
 Limites: 50 aplicações por workspace, 200 revisões por aplicação.
@@ -102,6 +107,17 @@ Leitura. A implantação mais recente, já conferida com a conta de nuvem, ou `n
 
 `status`: `deploying`, `running`, `failed` ou `stopped`.
 
+### `GET /apps/{ref}/logs`
+
+Leitura. Últimas linhas de log da implantação mais recente, da mais nova para a mais antiga
+(`?limit=`, padrão 100, até 200). Vale também para implantação que falhou ou já parou. Só em
+organização com a prévia do runtime; sem implantação, responde `409`. Limite: 20 leituras por minuto.
+
+```json
+{ "lines": [ { "time": "2026-11-12T10:05:00Z", "severity": "INFO", "text": "servidor no ar" } ],
+  "deployment": { "status": "running", "revision": 2 } }
+```
+
 ### `POST /apps/{ref}/deployments`
 
 Sessão de quem gerencia o workspace, ou chave com `compute:deploy`. Implanta a revisão atual.

package/docs/cli.md

@@ -1,9 +1,9 @@
 # Referência da CLI `aiuby`
 
-Versão 0.3.0. A CLI fala só com a API da AIUBY: nunca pede nem usa credenciais da AWS ou
+Versão 0.4.0. A CLI fala só com a API da AIUBY: nunca pede nem usa credenciais da AWS ou
 do Google Cloud.
 
-Instalação: `npm install -g https://aiuby.com/cli/aiuby-cli-latest.tgz` (Node.js 20 ou mais novo).
+Instalação: `npm install -g @aiuby-ia/cli` (Node.js 20 ou mais novo).
 
 ## Autenticação
 
@@ -53,6 +53,9 @@ runtime habilitada pela AIUBY. Fora dela, a API recusa com os motivos (código d
 | --- | --- |
 | `aiuby deploy [--no-wait] <identificador>` | Implanta a revisão atual no Google Cloud e acompanha até ficar em execução (até 3 minutos). Mostra o endereço público e o prazo. Reimplantar troca a revisão no mesmo endereço |
 | `aiuby stop <identificador>` | Para a implantação: o serviço é apagado e o endereço deixa de responder |
+| `aiuby billing` | Saldo pré-pago, teto mensal e gasto do mês de Compute no workspace, e os tamanhos com o preço por hora em uso |
+| `aiuby usage [--limit N]` | Extrato do Compute: períodos medidos e cobrados (padrão 50, até 200) |
+| `aiuby logs [--limit N] <identificador>` | Últimas linhas de log da implantação mais recente (padrão 100, até 200). Vale também para uma que falhou ou já parou |
 
 Limites da prévia: só CPU, até 1 vCPU e 1 GB, 1 réplica (escala a zero quando ociosa),
 endereço público sem autenticação, prazo de algumas horas. Sem cobrança nesta fase.
@@ -67,7 +70,7 @@ endereço público sem autenticação, prazo de algumas horas. Sem cobrança nes
 
 ## Ainda não disponíveis
 
-`run`, `logs`, `scale`, `rollback`, `volumes`, `secrets`
+`run`, `scale`, `rollback`, `volumes`, `secrets`
 e `domains` respondem que ainda não estão disponíveis e saem com código 4. Nenhum deles chama a API.
 
 ## Opções gerais

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiuby-ia/cli",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Linha de comando do AIUBY Compute",
   "type": "module",
   "bin": {

package/templates/hf-stable-diffusion/Dockerfile

@@ -0,0 +1,13 @@
+# Geração de imagem com um modelo de difusão do Hugging Face. O modelo é baixado na primeira
+# subida: escolha um cuja licença permita o seu uso e que caiba na memória da GPU pedida.
+FROM pytorch/pytorch:2.5.1-cuda12.4-cudnn9-runtime
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+COPY main.py .
+# Usuário sem privilégio: o runtime não deve precisar de root. O cache do modelo fica em /tmp.
+RUN useradd --create-home app
+USER app
+ENV MODEL_ID="stable-diffusion-v1-5/stable-diffusion-v1-5" HF_HOME="/tmp/hf"
+EXPOSE 8080
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8080"]

package/templates/hf-stable-diffusion/aiuby.toml

@@ -0,0 +1,21 @@
+# Geração de imagem em GPU. Valide com: aiuby config validate
+name = "Geração de imagem"
+slug = "geracao-de-imagem"
+
+[config]
+runtime = "container"
+image = "REGISTRO/geracao-de-imagem:1"
+port = 8080
+
+[config.hardware]
+provider = "gcp"
+cpu = 4
+memoryMb = 16384
+
+[config.hardware.gpu]
+sku = "gcp-cloudrun-l4"
+count = 1
+
+[config.scaling]
+minReplicas = 0
+maxReplicas = 1

package/templates/hf-stable-diffusion/main.py

@@ -0,0 +1,44 @@
+"""Geração de imagem com um modelo de difusão do Hugging Face, exposta por HTTP.
+O modelo é carregado uma vez, na subida; a primeira subida também faz o download."""
+import io
+import os
+from contextlib import asynccontextmanager
+
+import torch
+from diffusers import AutoPipelineForText2Image
+from fastapi import FastAPI
+from fastapi.responses import Response
+from pydantic import BaseModel, Field
+
+MODEL_ID = os.environ.get("MODEL_ID", "stable-diffusion-v1-5/stable-diffusion-v1-5")
+estado: dict = {}
+
+
+@asynccontextmanager
+async def ciclo(_: FastAPI):
+    gpu = torch.cuda.is_available()
+    pipe = AutoPipelineForText2Image.from_pretrained(MODEL_ID, torch_dtype=torch.float16 if gpu else torch.float32)
+    estado["pipe"] = pipe.to("cuda" if gpu else "cpu")
+    yield
+    estado.clear()
+
+
+app = FastAPI(title="geracao-de-imagem", lifespan=ciclo)
+
+
+class Pedido(BaseModel):
+    prompt: str = Field(min_length=1, max_length=500)
+    passos: int = Field(default=25, ge=1, le=50)
+
+
+@app.get("/health")
+def health() -> dict[str, str]:
+    return {"status": "ok", "modelo": MODEL_ID}
+
+
+@app.post("/gerar")
+def gerar(pedido: Pedido) -> Response:
+    imagem = estado["pipe"](pedido.prompt, num_inference_steps=pedido.passos).images[0]
+    saida = io.BytesIO()
+    imagem.save(saida, format="PNG")
+    return Response(content=saida.getvalue(), media_type="image/png")

package/templates/hf-stable-diffusion/requirements.txt

@@ -0,0 +1,6 @@
+fastapi>=0.115
+uvicorn>=0.30
+diffusers>=0.31
+transformers>=4.46
+accelerate>=1.0
+safetensors>=0.4

package/templates/yolo-detect/Dockerfile

@@ -0,0 +1,10 @@
+# Detecção de objetos com um modelo YOLO da Ultralytics. Os pesos são baixados na primeira
+# subida. Atenção à licença: a Ultralytics é AGPL-3.0; uso comercial fechado exige licença deles.
+FROM ultralytics/ultralytics:latest
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+COPY main.py .
+ENV MODEL_ID="yolov10x.pt" YOLO_CONFIG_DIR="/tmp/ultralytics"
+EXPOSE 8080
+CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8080"]

package/templates/yolo-detect/aiuby.toml

@@ -0,0 +1,21 @@
+# Detecção de objetos em GPU. Valide com: aiuby config validate
+name = "Detecção de objetos"
+slug = "deteccao-de-objetos"
+
+[config]
+runtime = "container"
+image = "REGISTRO/deteccao-de-objetos:1"
+port = 8080
+
+[config.hardware]
+provider = "gcp"
+cpu = 4
+memoryMb = 16384
+
+[config.hardware.gpu]
+sku = "gcp-cloudrun-l4"
+count = 1
+
+[config.scaling]
+minReplicas = 0
+maxReplicas = 1

package/templates/yolo-detect/main.py

@@ -0,0 +1,36 @@
+"""Detecção de objetos com YOLO (Ultralytics) exposta por HTTP: recebe uma imagem e devolve
+os objetos encontrados, com caixa e confiança."""
+import io
+import os
+
+from fastapi import FastAPI, File, HTTPException, UploadFile
+from PIL import Image
+from ultralytics import YOLO
+
+MODEL_ID = os.environ.get("MODEL_ID", "yolov10x.pt")
+LIMITE_BYTES = 10 * 1024 * 1024
+modelo = YOLO(MODEL_ID)
+
+app = FastAPI(title="deteccao-de-objetos")
+
+
+@app.get("/health")
+def health() -> dict[str, str]:
+    return {"status": "ok", "modelo": MODEL_ID}
+
+
+@app.post("/detectar")
+async def detectar(arquivo: UploadFile = File(...)) -> dict:
+    dados = await arquivo.read(LIMITE_BYTES + 1)
+    if len(dados) > LIMITE_BYTES:
+        raise HTTPException(status_code=413, detail="Imagem acima de 10 MB.")
+    try:
+        imagem = Image.open(io.BytesIO(dados)).convert("RGB")
+    except Exception as erro:  # arquivo que não é imagem
+        raise HTTPException(status_code=400, detail="O arquivo enviado não é uma imagem legível.") from erro
+    resultado = modelo(imagem, verbose=False)[0]
+    objetos = [
+        {"classe": resultado.names[int(caixa.cls)], "confianca": round(float(caixa.conf), 4), "caixa": [round(v, 1) for v in caixa.xyxy[0].tolist()]}
+        for caixa in resultado.boxes
+    ]
+    return {"objetos": objetos}

package/templates/yolo-detect/requirements.txt

@@ -0,0 +1,3 @@
+fastapi>=0.115
+uvicorn>=0.30
+python-multipart>=0.0.9