Guia de auto-hospedagem — 4 maneiras gratuitas de rodar o gerador de vídeo IA
Rode o Agnes Video Generator no seu próprio computador ou servidor: manual, Docker, npm ou agente de IA — escolha qualquer uma, totalmente grátis, sem GPU.
Requisitos do sistema
Verifique estes requisitos antes de implantar (pode pular com Docker — a imagem já inclui todas as dependências):
- Python 3.10+ (necessário para os métodos manual e npm)
- ffmpeg (apenas no método manual; Docker e npm já incluem)
- Node.js 18+ (apenas no método npm)
- Git (para clonar o repositório)
- Sem GPU, sem grande memória — todo o cálculo de IA acontece na nuvem, um notebook comum é suficiente
Quatro métodos de implantação
Escolha um e o serviço inicia; abra http://localhost:8765 no navegador.
Método A: implantação manual (start.sh)
A forma mais tradicional — ideal se você quiser ver cada etapa do que acontece.
git clone https://github.com/lcy362/agnes-video-generator.git cd agnes-video-generator ./start.sh
O script cria automaticamente um ambiente virtual, instala dependências e abre o navegador. Início manual: python3 -m venv .venv && .venv/bin/pip install -r requirements.txt && .venv/bin/python server.py
Método B: implantação com Docker
Sem instalar Python ou ffmpeg — um comando inicia o serviço; as imagens são publicadas no GHCR e no Docker Hub (linux/amd64 e linux/arm64).
docker run -d -p 8765:8765 \ -e AGNES_API_KEY=<sua-chave> \ -v ~/agnes-data/working:/app/.working_dir \ -v ~/agnes-data/config:/app/.agnes_config \ ghcr.io/lcy362/free-short-video:latest
Usuários do Docker Hub: troque o nome da imagem por lcy362/free-short-video:latest. Monte sempre os dois diretórios de dados, senão seus vídeos e configurações serão perdidos ao recriar o contêiner. No PowerShell, substitua as \ de fim de linha por crases `.
Método C: implantação com npm (CLI)
Um comando inicia todo o serviço — sem clonar, sem configurar ambiente manualmente, ffmpeg incluído automaticamente.
npx free-short-video # Ou instale globalmente e execute: free-short-video (alias curto: fsv) AGNES_API_KEY=<sua-chave> npx free-short-video
Opções: --port <n> para mudar a porta, --host 0.0.0.0 para acesso pela rede local, --no-open para não abrir o navegador automaticamente. A primeira execução cria o ambiente virtual e instala dependências automaticamente.
Método D: implantação assistida por agente de IA
O projeto foi feito para assistentes de programação de IA — deixe um agente cuidar da implantação.
git clone https://github.com/lcy362/agnes-video-generator.git cd agnes-video-generator # Depois diga ao seu agente de IA: "Leia o AGENTS.md deste projeto, instale as dependências, configure a chave de API e inicie o serviço."
O projeto inclui um guia de implantação AGENTS.md com uma lista de verificação em quatro camadas que o agente executa e reporta.
Como confirmar a implantação
- O navegador abre (ou você visita) http://localhost:8765 — ver a interface do Agnes Video Generator significa sucesso
- Cole sua chave de API gratuita no topo da página e comece a gerar
- Referência de tempo: vídeo simples ≈ 1–3 min, vídeo longo criativo (5 cenas) ≈ 10–20 min
Dicas de uso
- Retomar: após uma interrupção, reinicie o serviço e clique em "Retomar" na tarefa inacabada da lista
- Diretório de saída: todos os arquivos ficam em .working_dir/{timestamp}_{task_id}/; final_video.mp4 é o vídeo final (com narração e legendas)
- Porta ocupada: se a porta 8765 estiver em uso, execute lsof -ti:8765 | xargs kill no macOS/Linux; no Windows use netstat -ano | findstr :8765 para achar o PID e depois taskkill
- Há um limite de 16 chamadas de API por minuto — ele existe para manter o serviço gratuito; não é que seu computador seja lento
Não quer instalar?
Abra o site oficial e experimente online gratuitamente — sem necessidade de instalação.
Experimentar online →Páginas relacionadas
Obtenha uma chave de API Agnes AI grátis — configuração em 3 minutos | Guia gratuito de vídeo IA
As chaves de API Agnes AI são totalmente gratuitas: passos completos de registro, criação e cópia, três métodos de configuração (interface Web / variável de ambiente / API) e solução do erro 401.
API Texto para Vídeo — API de geração de vídeo IA grátis | Agnes Video
Chamada programática do modelo de vídeo gratuito Agnes AI: texto em vídeo, imagem em vídeo, geração de narração, etc. Cobertura completa da API REST, incluindo parâmetros de solicitação, autenticação do portador, sondagem de status de tarefa e exemplos de código completos (Python/cURL/HTTP). Amigável para desenvolvedores, custo zero e não requer uma placa gráfica de alto desempenho para acessar.
Início rápido: guia de geração gratuita de vídeo com IA
Desde a obtenção da chave API gratuita até a geração do primeiro vídeo de IA, este guia de início rápido o levará passo a passo: cadastre-se para obter a chave, preencha a página, escreva palavras de prompt, escolha o modo e a duração, espere para renderização e baixe em um filme. Não há necessidade de pagar por todo o processo, não há necessidade de uma placa gráfica de alto desempenho, você pode começar em poucos minutos e você pode fazer isso sem experiência técnica.
Deployment Documentation
The four deployment methods here (manual / Docker / npm / AI agent) follow the project repo and the official docs below.
- agnes-video-generator — 开源 AI 视频生成项目lcy362 · GitHub (2026)
Deployment scripts like start.sh/server.py and the default port (8765) follow the open-source repository.
- FFmpeg Documentation — 音视频处理官方文档FFmpeg 项目 · ffmpeg.org (2025)
The ffmpeg dependency for manual deployment is covered in the official FFmpeg documentation.
- Docker Documentation — 容器化部署Docker · docs.docker.com (2025)
Building and running the Docker image follows the official Docker documentation.
- Node.js — JavaScript 运行时文档OpenJS Foundation · nodejs.org (2025)
The Node.js 18+ requirement for the npm method is documented on the official Node.js site.
Por que você pode confiar
Este artigo foi escrito por profissionais da linha de frente. Ao escrevê-lo, fontes de primeira mão, como artigos arXiv, relatórios técnicos de fabricantes e Stanford AI Index, foram verificadas e não baseadas em conclusões subjetivas.
SandGrid@lcy362
Autor do Agnes Video Generator · Desenvolvedor Full-Stack
Desenvolvedor independente e autor da ferramenta de geração de vídeo de IA de código aberto Agnes Video Generator. O projeto é baseado no modelo de vídeo totalmente gratuito da Agnes AI, com protocolo MIT de código aberto e ajudou mais de 1.000 criadores a produzir vídeos de IA a custo zero. Há muito tempo estou preocupado com a engenharia e popularização de modelos de geração de vídeo, e o conteúdo do artigo vem da prática de primeira linha e da pesquisa em primeira mão.
Ver no GitHubÚltima atualização：2026-08-21
Pronto para começar?
“Deixe a IA de classe mundial pertencer a todos.” – Bruce Yang. Completamente grátis, sem cartão de crédito ou placa gráfica de alto desempenho, faça seu primeiro vídeo de IA a zero custo. Quer usar o modelo de vídeo gratuito da Agnes AI? Basta começar daqui.
Clone o repositório do GitHub e inicie em 2 minutos