Agnes Video Generator

Guida all'auto-hosting — 4 modi gratuiti per eseguire il generatore video IA

Esegui Agnes Video Generator sul tuo computer o server: manuale, Docker, npm o agente IA — scegline una, completamente gratuito, senza GPU.

Requisiti di sistema

Verifica questi requisiti prima del deployment (puoi saltarli con Docker — l'immagine include tutte le dipendenze):

  • Python 3.10+ (necessario per i metodi manuale e npm)
  • ffmpeg (solo metodo manuale; Docker e npm lo includono)
  • Node.js 18+ (solo metodo npm)
  • Git (per clonare il repository)
  • Niente GPU, niente grande memoria — tutti i calcoli IA avvengono nel cloud, un normale portatile è sufficiente

Quattro metodi di deployment

Scegline uno e il servizio parte; apri http://localhost:8765 nel browser.

Metodo A: deployment manuale (start.sh)

Il modo più tradizionale — ideale se vuoi vedere ogni passaggio.

git clone https://github.com/lcy362/agnes-video-generator.git
cd agnes-video-generator
./start.sh

Lo script crea automaticamente un ambiente virtuale, installa le dipendenze e apre il browser. Avvio manuale: python3 -m venv .venv && .venv/bin/pip install -r requirements.txt && .venv/bin/python server.py

Metodo B: deployment Docker

Nessuna installazione di Python o ffmpeg — un comando avvia il servizio; le immagini sono pubblicate su GHCR e Docker Hub (linux/amd64 e linux/arm64).

docker run -d -p 8765:8765 \
  -e AGNES_API_KEY=<tua-chiave> \
  -v ~/agnes-data/working:/app/.working_dir \
  -v ~/agnes-data/config:/app/.agnes_config \
  ghcr.io/lcy362/free-short-video:latest

Utenti Docker Hub: sostituisci il nome dell'immagine con lcy362/free-short-video:latest. Monta sempre entrambe le directory dati, altrimenti video e impostazioni andranno persi alla ricreazione del container. In PowerShell sostituisci le \ di fine riga con i backtick `.

Metodo C: deployment npm (CLI)

Un comando avvia l'intero servizio — senza clonare, senza configurare l'ambiente, ffmpeg incluso automaticamente.

npx free-short-video
# Oppure installa globalmente ed esegui: free-short-video (alias breve: fsv)
AGNES_API_KEY=<tua-chiave> npx free-short-video

Opzioni: --port <n> per cambiare porta, --host 0.0.0.0 per l'accesso dalla LAN, --no-open per non aprire automaticamente il browser. Il primo avvio crea l'ambiente virtuale e installa le dipendenze automaticamente.

Metodo D: deployment assistito da agente IA

Il progetto è pensato per gli assistenti di programmazione IA — lascia che un agente gestisca il deployment.

git clone https://github.com/lcy362/agnes-video-generator.git
cd agnes-video-generator
# Poi di' al tuo agente IA:
"Leggi il AGENTS.md di questo progetto, installa le dipendenze, configura la chiave API e avvia il servizio."

Il progetto include una guida al deployment AGENTS.md con una checklist di verifica a quattro livelli che l'agente esegue e riporta.

Come verificare il deployment

  • Il browser si apre (o visiti) http://localhost:8765 — vedere l'interfaccia di Agnes Video Generator significa successo
  • Incolla la tua chiave API gratuita in alto nella pagina e inizia a generare
  • Riferimenti di tempo: video semplice ≈ 1–3 min, video lungo creativo (5 scene) ≈ 10–20 min

Consigli d'uso

  • Riprendi: dopo un'interruzione, riavvia il servizio e clicca su "Riprendi" sull'attività incompleta nell'elenco
  • Directory di output: tutti i file sono in .working_dir/{timestamp}_{task_id}/; final_video.mp4 è il video finale (con narrazione e sottotitoli)
  • Porta occupata: se la porta 8765 è in uso, esegui lsof -ti:8765 | xargs kill su macOS/Linux; su Windows usa netstat -ano | findstr :8765 per trovare il PID e poi taskkill
  • C'è un limite di 16 chiamate API al minuto — esiste per mantenere il servizio gratuito; non è che il tuo computer sia lento

Non vuoi installare?

Apri il sito ufficiale e provalo online gratuitamente — nessuna installazione necessaria.

Provalo online →

Pagine correlate

Ottieni una chiave API Agnes AI gratuita — configurazione in 3 minuti | Guida gratuita al video IA

Le chiavi API Agnes AI sono completamente gratuite: passaggi completi per registrazione, creazione e copia, tre metodi di configurazione (interfaccia Web / variabile d'ambiente / API) e risoluzione dell'errore 401.

API Testo in Video — API generazione video IA gratuita | Agnes Video

Chiama programmatica del modello video gratuito Agnes AI: testo in video, immagine in video, generazione di narrazione, ecc. Copertura completa dell'API REST, inclusi parametri di richiesta, autenticazione del portatore, sondaggio sullo stato dell'attività ed esempi di codice completi (Python/cURL/HTTP). Adatto agli sviluppatori, a costo zero e non richiede una scheda grafica ad alte prestazioni per accedere.

Avvio rapido: guida alla generazione gratuita di video AI

Dall'ottenimento della chiave API gratuita alla generazione del primo video AI, questa guida di avvio rapido ti guiderà passo dopo passo: registrati per ottenere la chiave, compila la pagina, scrivi parole prompt, seleziona la modalità e la durata, aspetta il rendering e scarica in un film. Non è necessario pagare per l'intero processo, non è necessaria una scheda grafica ad alte prestazioni, puoi iniziare in pochi minuti e puoi farlo senza alcun background tecnico.

Deployment Documentation

The four deployment methods here (manual / Docker / npm / AI agent) follow the project repo and the official docs below.

  1. agnes-video-generator — 开源 AI 视频生成项目lcy362 · GitHub (2026)

    Deployment scripts like start.sh/server.py and the default port (8765) follow the open-source repository.

  2. FFmpeg Documentation — 音视频处理官方文档FFmpeg 项目 · ffmpeg.org (2025)

    The ffmpeg dependency for manual deployment is covered in the official FFmpeg documentation.

  3. Docker Documentation — 容器化部署Docker · docs.docker.com (2025)

    Building and running the Docker image follows the official Docker documentation.

  4. 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.

Perché puoi fidarti

Questo articolo è stato scritto da professionisti in prima linea. Durante la scrittura, ha controllato fonti di prima mano come documenti arXiv, rapporti tecnici dei produttori e Stanford AI Index. Non si basa su conclusioni basate su impressioni soggettive.

S

SandGrid@lcy362

Autore di Agnes Video Generator · Sviluppatore Full-Stack

Sviluppatore indipendente e autore di Agnes Video Generator, uno strumento di generazione di Video AI open source. Il progetto si basa sul modello video completamente gratuito di Agnes AI, con il protocollo MIT open source e ha aiutato oltre 1.000 creatori a produrre video AI a costi zero. Da tempo presto attenzione all'ingegneria e alla divulgazione dei modelli di generazione video e il contenuto dell'articolo deriva dalla pratica in prima linea e dalla ricerca di prima mano.

Vedi su GitHub

Ultimo aggiornamento：2026-08-21

Pronto per iniziare?

“Lascia che l’IA di livello mondiale appartiene a tutti.” – Bruce Yang. Completamente gratuito, nessuna carta di credito o scheda grafica ad alte prestazioni, crea il tuo primo video AI a costi zero. Vuoi usare il modello video gratuito di Agnes AI? Inizia da qui.

Prova demo onlineInizia gratis

Clona il repository GitHub e avvia in 2 minuti