Seu primeiro projeto Django em 15 minutos

✅ Artigo atualizado em Setembro 2026 Fluxo executado de ponta a ponta no Django 6.1 (versão estável atual). Corrigimos a informação de versão (a LTS atual é a 5.2, não a 5.1), a saída real do runserver e o que o makemigrations faz num projeto novo.

Salve salve Pythonista!

Django é um framework de desenvolvimento web em Python que permite criar aplicações robustas e escaláveis.

Se você é um desenvolvedor iniciante ou está procurando expandir suas habilidades em Python, o Django é uma ótima escolha.

Neste artigo, vamos abordar os primeiros passos para iniciar seu projeto Django, desde a instalação até a execução do servidor local.

Este artigo faz parte do Guia Completo de Django. Lá você encontra o caminho inteiro, da instalação ao deploy: Models, Views, Templates, Forms, Admin, bancos de dados, boas práticas e DRF.

Vá Direto ao Assunto…

• Instalação do Django
• Criando um novo projeto Django
• O poder do manage.py

Instalação do Django

Antes de começar a desenvolver com Django, é necessário fazer a instalação do framework.

Felizmente, isso é um processo simples e rápido.

O Django pode ser instalado usando o pip, o gerenciador de pacotes do Python.

E é claro que você vai querer utilizar um Ambiente Virtual para isso (clique aqui para saber mais sobre Ambientes Virtuais).

Abra seu terminal e execute o seguinte comando:

1

pip install django

Isso irá instalar a versão mais recente do Django compatível com o seu Python.

Versões atuais (Setembro 2026): a versão estável é o Django 6.1, que exige Python 3.12 ou mais recente. A versão de suporte longo (LTS) é o Django 5.2, com correções de segurança até abril de 2028 e compatível com Python 3.10 a 3.14. Se o seu Python for 3.10 ou 3.11, o pip instala automaticamente a série 5.2. Para fixar a LTS de propósito, use pip install "django>=5.2,<5.3".

Para conferir a versão instalada, rode django-admin --version.

Criando um novo projeto Django

Após a instalação do Django, você está pronto para criar seu primeiro projeto.

O Django fornece um utilitário de linha de comando chamado django-admin para ajudar na criação de projetos.

Execute o seguinte comando:

1

django-admin startproject seu_projeto

Isso criará um novo diretório chamado seu_projeto com a estrutura inicial do projeto.

Dentro dele, você encontrará um arquivo chamado manage.py, que será seu melhor amigo durante o desenvolvimento. Vamos falar mais sobre ele posteriormente.

Na imagem abaixo, você pode ver uma representação visual da estrutura inicial do projeto (no exemplo da imagem, o projeto se chama primeiro_projeto):

Agora vamos entender cada um desses arquivos:

• O diretório raiz do projeto contém o arquivo manage.py e um subdiretório com o mesmo nome do seu projeto.
• O subdiretório com o nome do seu projeto contém os arquivos de configuração principais.
• O arquivo settings.py contém as configurações do projeto, como banco de dados, aplicativos instalados, caminhos para arquivos estáticos, entre outros.
• O arquivo urls.py é usado para mapear as URLs da sua aplicação para as funções que manipularão as requisições.
• O arquivo wsgi.py é usado para iniciar o servidor WSGI (Web Server Gateway Interface) quando você deseja implantar o projeto em um servidor de produção.
• O arquivo asgi.py é usado para iniciar o servidor utilizando ASGI (Asynchronous Server Gateway Interface) quando você deseja implantar o projeto em um servidor de produção, utilizando servidores web assíncronos.

💡 WSGI ou ASGI? O Django gera os dois arquivos e os dois são suportados. WSGI continua sendo uma escolha perfeitamente válida para a maioria dos projetos (o próprio runserver usa WSGI). ASGI vale a pena quando você usa views assíncronas (async def) de forma intensa ou precisa de conexões de longa duração, como WebSockets (que, no Django, exigem um pacote extra como o Django Channels).

O manage.py é só a porta de entrada - para dominar Django de verdade, de model a view, com projetos guiados, conheça a Jornada Python:

Domine Python: A Linguagem da Inteligência Artificial, do Desenvolvimento Web e das Carreiras do Futuro.

A mais completa formação para você se tornar um especialista em Python, pronto para construir desde aplicações web robustas com Django até projetos de Inteligência Artificial e Ciência de Dados .

Quero conhecer!

Nota 4,9 de 5 na Hotmart O curso de Python mais bem avaliado da Hotmart!

O poder do manage.py

Agora, vamos falar um pouco mais sobre o manage.py.

Esse arquivo é a espinha dorsal do seu projeto Django, e você irá usá-lo com frequência, pode acreditar

O manage.py permite executar uma variedade de comandos úteis, como migrações de banco de dados, execução de testes, criação de superusuários e muito mais.

Para usar o manage.py, abra seu terminal, navegue até o diretório raiz do seu projeto e execute os comandos a seguir.

Executando o servidor local

Para testar seu projeto localmente, sem a necessidade de implantá-lo em um servidor de produção, você pode executar o servidor de desenvolvimento embutido do Django através do comando runserver.

Para isso, execute o seguinte em seu terminal:

1

python manage.py runserver

Isso iniciará o servidor na porta padrão 8000. Você verá uma saída semelhante à seguinte (Django 6.1.1):

1
2
3
4
5
6
7
8
9
10
11
12
13
14

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
September 27, 2026 - 13:59:55
Django version 6.1.1, using settings 'seu_projeto.settings'
Starting WSGI development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

WARNING: This is a development server. Do not use it in a production setting. Use a production WSGI or ASGI server instead.
For more information on production servers see: https://docs.djangoproject.com/en/6.1/howto/deployment/

O aviso de unapplied migrations é normal num projeto recém-criado: ele some depois que você roda o migrate (veja abaixo). O aviso final lembra que o runserver é só para desenvolvimento.

Agora, abra seu navegador e acesse http://127.0.0.1:8000/.

Você verá a seguinte página de boas-vindas do Django, indicando que seu servidor está funcionando corretamente.

Está curtindo esse conteúdo?

Que tal receber 30 dias de conteúdo direto na sua Caixa de Entrada?

Sua assinatura não pôde ser validada.

Você fez sua assinatura com sucesso.

Assine as PyDicas e receba 30 dias do melhor conteúdo Python na sua Caixa de Entrada: direto e sem enrolação!

Seu nome

Seu e-mail

ASSINAR PYDICAS

Outros comandos úteis

Além do comando runserver, o manage.py oferece várias outras funcionalidades úteis para o desenvolvimento do seu projeto Django.

Vejamos alguns exemplos:

Migrações: O Django possui um sistema de migrações embutido, que permite gerenciar o estado do seu banco de dados. Para criar e aplicar migrações, execute os seguintes comandos:

1
2

python manage.py makemigrations
python manage.py migrate

O primeiro comando cria arquivos de migração a partir das alterações nos seus models. Num projeto recém-criado ele responde No changes detected, porque você ainda não criou nenhum model (e os apps nativos, como auth e admin, já trazem suas migrações prontas). O segundo aplica todas as migrações pendentes no banco de dados, criando as tabelas (sem precisar de uma linha de SQL para isso!). Num projeto novo, o migrate aplica as 18 migrações dos apps nativos.

Criar um superusuário: Durante o desenvolvimento, é comum precisar de um usuário com permissões administrativas para acessar a área admin do Django.

Para criar um superusuário, execute o seguinte comando:

1

python manage.py createsuperuser

Executando testes: O Django fornece um framework de testes integrado. Você pode escrever testes para verificar o comportamento do seu aplicativo e, para executá-los, use o seguinte comando:

1

python manage.py test

Esses são apenas alguns exemplos dos muitos comandos que o manage.py oferece.

Estou construindo o Ebookr.ai, uma plataforma onde você cria ebooks profissionais com IA sobre qualquer assunto - do zero ao PDF pronto, com capas e infográficos gerados automaticamente. Dá uma olhada!

Conclusão

Neste artigo, você aprendeu sobre os primeiros passos para iniciar seu projeto Django.

Vimos como instalar o Django, criar um novo projeto e explorar a estrutura inicial.

Além disso, você foi apresentado ao poderoso manage.py, que permite executar uma variedade de comandos úteis.

O Django é uma ferramenta poderosa para o desenvolvimento web em Python.

Agora que você tem uma base sólida, você pode começar a desenvolver suas próprias aplicações web usando Django.

Aproveite todo o potencial deste framework e não hesite em explorar a vasta documentação disponível para descobrir ainda mais recursos.

Parabéns pelo seu primeiro projeto Django! Que você tenha sucesso em todas as suas empreitadas no mundo do desenvolvimento web.

Se quiser continuar e construir um projeto Django completo, do model às APIs REST, conheça a Jornada Python, nosso curso de Python completo.

Tamo junto!

Por Vinícius Ramos em 12/09/2023

Engenheiro de Computação pela UnB com especialização em Inteligência Artificial. Sr. Software Engineer com 10+ anos de experiência desenvolvendo sistemas críticos em Python e Django. Atuei no Banco do Brasil liderando equipes para monitoramento de mainframe, trabalhei como desenvolvedor sênior em projetos forenses para a Polícia Federal, e atualmente sou engenheiro de software na Labcorp (Estados Unidos), desenvolvendo soluções escaláveis para testes genéticos. Fundador da Python Academy, compartilhando conhecimento técnico com a comunidade brasileira desde 2018.

Bora se conectar no LinkedIn! vinicius-aramos

Minhas redes:

• 
• 
•