HKUDS/DeepTutor · error · ManimRenderError

Rendered video artifact missing for visual review.

Error message

Rendered video artifact missing for visual review.

What it means

Error "Rendered video artifact missing for visual review." thrown in HKUDS/DeepTutor.

Source

Thrown at deeptutor/agents/math_animator/visual_review.py:56

                for artifact in render_result.artifacts
            ]

        video_artifact = next(
            (artifact for artifact in render_result.artifacts if artifact.type == "video"), None
        )
        if video_artifact is None:
            return []

        video_path = self.artifacts_dir / video_artifact.filename
        frame_paths = await self._extract_video_frames(video_path)
        await self._emit_progress(
            f"Prepared {len(frame_paths)} review frame(s) from rendered video."
        )
        return [self._path_to_attachment(path) for path in frame_paths]

    async def _extract_video_frames(self, video_path: Path) -> list[Path]:
        if not video_path.exists():
            raise ManimRenderError("Rendered video artifact missing for visual review.")

        duration = await self._probe_duration(video_path)
        timestamps = self._choose_timestamps(duration)
        frame_paths: list[Path] = []
        for idx, timestamp in enumerate(timestamps, start=1):
            frame_path = self.review_dir / f"review_frame_{idx:02d}.png"
            command = [
                "ffmpeg",
                "-y",
                "-ss",
                f"{timestamp:.3f}",
                "-i",
                str(video_path),
                "-frames:v",
                "1",
                str(frame_path),
            ]
            await self._emit_progress(

View on GitHub (pinned to 3e82f13042)

When it happens

Trigger: Thrown at deeptutor/agents/math_animator/visual_review.py:56 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of HKUDS/DeepTutor@3e82f13042 (2026-08-27). Data as JSON: /api/errors/b83476170d6ad2d9. Report an issue: GitHub.