# FastAPI CLI { #fastapi-cli } **FastAPI CLI** é um programa de linha de comando que você pode usar para servir sua aplicação FastAPI, gerenciar seu projeto FastAPI e muito mais. Quando você instala o FastAPI (por exemplo, com `pip install "fastapi[standard]"`), ele vem com um programa de linha de comando que você pode executar no terminal. Para executar sua aplicação FastAPI durante o desenvolvimento, você pode usar o comando `fastapi dev`:
```console $ fastapi dev FastAPI Starting development server 🚀 Searching for package file structure from directories with __init__.py files Importing from /home/user/code/awesomeapp module 🐍 main.py code Importing the FastAPI app object from the module with the following code: from main import app app Using import string: main:app server Server started at http://127.0.0.1:8000 server Documentation at http://127.0.0.1:8000/docs tip Running in development mode, for production use: fastapi run Logs: INFO Will watch for changes in these directories: ['/home/user/code/awesomeapp'] INFO Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit) INFO Started reloader process [383138] using WatchFiles INFO Started server process [383153] INFO Waiting for application startup. INFO Application startup complete. ```
/// tip | Dica Em produção, você usaria `fastapi run` em vez de `fastapi dev`. 🚀 /// Internamente, o **FastAPI CLI** usa o [Uvicorn](https://www.uvicorn.dev), um servidor ASGI de alta performance e pronto para produção. 😎 O CLI `fastapi` tentará detectar automaticamente a aplicação FastAPI a ser executada, assumindo que seja um objeto chamado `app` em um arquivo `main.py` (ou algumas outras variantes). Mas você pode configurar explicitamente a aplicação a ser usada. ## Configure o `entrypoint` da aplicação em `pyproject.toml` { #configure-the-app-entrypoint-in-pyproject-toml } Você pode configurar onde sua aplicação está localizada em um arquivo `pyproject.toml`, assim: ```toml [tool.fastapi] entrypoint = "main:app" ``` Esse `entrypoint` dirá ao comando `fastapi` que ele deve importar a aplicação assim: ```python from main import app ``` Se o seu código estivesse estruturado assim: ``` . ├── backend │   ├── main.py │   ├── __init__.py ``` Então você definiria o `entrypoint` como: ```toml [tool.fastapi] entrypoint = "backend.main:app" ``` o que seria equivalente a: ```python from backend.main import app ``` ### `fastapi dev` com caminho { #fastapi-dev-with-path } Você também pode passar o caminho do arquivo para o comando `fastapi dev`, e ele deduzirá o objeto da aplicação FastAPI a usar: ```console $ fastapi dev main.py ``` Mas você teria que lembrar de passar o caminho correto toda vez que chamar o comando `fastapi`. Além disso, outras ferramentas podem não conseguir encontrá-la, por exemplo a [Extensão do VS Code](editor-support.md) ou a [FastAPI Cloud](https://fastapicloud.com), então é recomendado usar o `entrypoint` em `pyproject.toml`. ## `fastapi dev` { #fastapi-dev } Executar `fastapi dev` inicia o modo de desenvolvimento. Por padrão, o **recarregamento automático** está ativado, recarregando o servidor automaticamente quando você faz mudanças no seu código. Isso consome muitos recursos e pode ser menos estável do que quando está desativado. Você deveria usá-lo apenas no desenvolvimento. Ele também escuta no endereço IP `127.0.0.1`, que é o IP para a sua máquina se comunicar apenas consigo mesma (`localhost`). ## `fastapi run` { #fastapi-run } Executar `fastapi run` inicia o FastAPI em modo de produção. Por padrão, o **recarregamento automático** está desativado. Ele também escuta no endereço IP `0.0.0.0`, o que significa todos os endereços IP disponíveis; dessa forma, ficará acessível publicamente para qualquer pessoa que consiga se comunicar com a máquina. É assim que você normalmente o executaria em produção, por exemplo, em um contêiner. Na maioria dos casos, você teria (e você deveria ter) um "proxy de terminação" tratando o HTTPS por cima; isso dependerá de como você faz o deploy da sua aplicação, seu provedor pode fazer isso por você ou talvez seja necessário que você configure isso por conta própria. /// tip | Dica Você pode aprender mais sobre isso na [documentação de deployment](deployment/index.md). ///