AKARI Video / How-to guide / Your first video 日本語 GitHub ↗

HOW TO — 2 / 6

Your first video

Starting with one video you have already shot, we will go from creating a project to a finished MP4. You do not need to memorize commands: the example prompts are ordinary conversational Japanese, translated into English here.

Last updated 2026-08-10 AKARI Video v0.1.6 Allow 30 minutes or more

1 — Create a project

Just say “I want to create a project”

Once you have installed it, launch akari and tell the AI agent:

YouI want to create a new video project.
AILet's name the project. What kind of video do you want to make? … (Creates the scaffold)

One video = one folder. The template automatically creates the following:

my-video/A self-contained box for one video
├─ assets/Put your footage here
├─ planning/Plans and outlines collect here
├─ exports/Finished videos appear here
└─ .akari/Workflow form and work log (the AI's toolbox)

See the File map for details on each folder. For now, just remember: footage goes into assets/, and finished videos come out of exports/.

2 — Choose your workflow

Answer three questions, including how much to delegate

Each project has a Workflow form (進め方フォーム). Fill it in so the AI can start working. It is a form, but you only need to answer in chat:

YouI want to fill in the workflow form.
AIThree questions: ① What do you want to make? ② What length and output format? ③ How much should I handle on my own?
YouOne short video from my footage. A 60-second vertical video. I want to review it at key stages.
QuestionMeaningExample answer
Task (やること)What you want to make“One short video from my footage”
Length / output (尺・出力先)Duration and format“60 seconds, vertical”
Autonomy (おまかせ度)How independently the AI may workChoose one of the three levels below
Autonomy (おまかせ度)Behavior
checkpoint(default, recommended)Asks for approval only at key stages (editing plan and export), and handles the rest independently
collaborativeDiscusses each step with you. For people who want detailed involvement
full-autoWorks through to the end without asking. Best once you are familiar with the workflow

3 — Add footage and finish the video

Just four main stages from here

1
Add footage and ask for analysis You → AI

Put your footage in assets/ (dragging in Finder is fine), then say:

YouAnalyze this video.

The AI automatically creates a lightweight review video (a 720p proxy), a transcript, and keyframes. This runs locally, so it is free.

Approve the editing plan Checkpoint ①
YouMake an editing plan.
AIBased on the analysis, I suggest using this part of the first 12 seconds as the hook. Here is why… (Report with thumbnails)

The AI explains its cut choices in a report with images and edits only after you approve. If the plan does not suit you, request changes here.

2
The first cut is ready AI

Following your approved plan, the AI assembles a first cut with cuts, telops, subtitles, and background music. All edits are recorded in one save-data file, edit.json.

3
Open and fix You

Play the preview, drag telops to move them, and double-click to fix text. See the next page, Open and fix, for details.

Approve the export Checkpoint ②
YouExport the video.
AIThe automated checks (lint) passed. I will export this edit. Shall I proceed?

Once you approve, the final render uses the original footage and saves an MP4 in exports/. The AI then checks the output with automated verification and visual inspection.

4 — Additional notes

Start even without footage or a budget

If you have no footage

Start with “I want to make a video.” The AI asks questions, develops a plan, and suggests how to source assets (concept → outline → storyboard → shot list).

About costs

Work handled locally—proxy generation, transcription, editing, and export—is free. Charges apply only when using external APIs, such as cloud transcription or narration generation. Setup and approval are always required beforehand.

Previous page← 1. Install