kimi3manim
تبدیل مفاهیم ریاضی و فیزیک به فیلمهای آموزشی رندرشده با Manim
این اسکیل با اجرای یک خط لولهی ششمرحلهای، مفهوم ریاضی یا فیزیکی شما را به طرح آموزشی، روایت، کد Manim و در نهایت فیلم MP4 تبدیل میکند. از هندسهی مدرسه تا مباحث پیشرفتهی فیزیک و ریاضیات را پشتیبانی میکند.
فرآیند شامل طراحی بصری، تولید صحنه، رندر 1080p و بررسی کیفیت خروجی است. میتوانید اجرای ناموفق را ادامه دهید، صحنهای موجود را دوباره رندر کنید و ویدیویی آمادهی ارائه یا آموزش تحویل بگیرید.
چه چیزی میگیرید
- تبدیل یک مفهوم ریاضی یا فیزیکی به فیلم آموزشی MP4
- خط لولهی چندعاملی برای تحلیل مفهوم، روایتپردازی و طراحی بصری
- تولید و رندر صحنههای Manim با کیفیتهای 480p تا 4K
- امکان ادامهدادن اجرای ناموفق و رندر مجدد بدون فراخوانی مدل
- بررسی خوانایی معادلات و هماهنگی صحنهها با مشخصات بصری
برای چه کاری خوب است
- مدرسها و تولیدکنندگان محتوای آموزشی ریاضی یا فیزیک
- توسعهدهندگانی که میخواهند ایدههای علمی را به انیمیشن Manim تبدیل کنند
- پروژههایی که به ویدیوی توضیحی برای مفاهیمی مانند هندسه، مکانیک یا جبر نیاز دارند
برای چه کاری نیست
- ساخت انیمیشنهای عمومی، تبلیغاتی یا سینمایی که به Manim وابسته نیستند
- پروژههایی که به خروجی فوری و بدون نصب وابستگیهای رندر نیاز دارند
- مفاهیمی که به محتوای دقیق علمی و بازبینی انسانی نیاز دارند اما زمان بررسی خروجی ندارند
دربارهٔ این اسکیل
Kimi3Manim: concept to rendered film
Drive the Kimi3Manim six-agent pipeline (Concept Scout, Mathematical
Enricher, Visual Designer, Narrative Composer, Manim Coder, vision Render
Critic under a deterministic supervisor) to turn any math or physics
concept into a rendered 1080p Manim film.
When to Use
- The user asks to animate, visualize, or make a video/film of a mathematical or physical concept, at any level from middle-school geometry to graduate physics.
- The user wants to resume or debug a failed animation run.
- The user wants an existing Manim scene re-rendered.
Quick Reference
| Task | Command (run in the repo directory) |
|---|---|
| Full pipeline, concept to mp4 | uv run python -m k3_agents.supervisor "<concept>" --quality qh |
| Resume failed run at Stage 5 | uv run python resume_pipeline.py [run_dir] |
| Re-render a scene, no model calls | uv run manim -qh <file.py> <SceneClass> |
| One-time subscription login | uv run kimi login |
| Install deps | uv sync |
Quality flags: ql 480p (smoke test), qm 720p, qh 1080p, qk 4K.--max-repairs N bounds coder/critic repair rounds (default 3).
Procedure
- Locate the repo (config
kimi3manim.repo, default~/KimiK3Manim). Missing?git clone https://github.com/HarleyCoops/KimiK3Manim.git, thenuv syncinside it. System deps: ffmpeg, texlive, texlive-latex-extra, dvisvgm. - Verify auth: either the user ran
uv run kimi loginonce (Kimi Code OAuth subscription - the default), orMOONSHOT_API_KEYis set in.env(also enables the vision critic stage). - Warn the user that a full run takes minutes and spends Kimi quota (six kimi-k3 calls at max reasoning plus rendering); never launch runs in parallel.
- Phrase the concept the way the intended audience would ask it - the Scout calibrates prerequisite depth from the phrasing. "why the Pythagorean theorem is true" is as valid as "the double cover of SO(3)".
- Run the supervisor command. The built-in preflight aborts with exact instructions if the environment is broken - relay its message verbatim and fix the environment; do not retry the pipeline.
- Outputs land in
output/k3_runs/<slug>/: numbered JSON artifacts (01 knowledge graph ... 06 critique), generated scenes inscenes/, per-attemptrender_attemptN.log, and the mp4 undermedia/. Deliver the mp4.[[as_document]]
Pitfalls
- Environment failures (missing manim/latex/pango) are NOT code bugs: the supervisor aborts on them by design. Fix the environment; never feed them to the coder repair loop.
- Re-running the same concept reuses its run directory - move it aside first for a clean slate.
- Subscription-only auth cannot run the Stage 6 vision critic; the run stops after rendering with the mp4 already on disk. Ship it and note the critic was skipped, or set MOONSHOT_API_KEY to enable it.
- On WSL, keep the clone in the Linux filesystem (not /mnt/c) or uv and renders run slowly;
export UV_LINK_MODE=copysilences the hardlink warning.
Verification
- The run directory contains an mp4 under
media/and artifacts 01-05. - On failure, read the newest
render_attemptN.login the run dir BEFORE re-running; it contains the real traceback. - Sample a few frames (
ffmpeg -ss <t> -i <mp4> -frames:v 1 f.png) and confirm equations are legible and scenes match the visual spec before presenting the film as final.