GIGIlistening…

Build Journal

Tavus Video Personas & AI Portal Enhancements — May 1, 2026

I enhanced Tavus video personas and AI portal capabilities, fixing issues and improving UX for better performance and user engagement.

19 changes3 min readby Rob

What shipped

  • Admin Refund UIAdded admin invocation for refunds with automatic handling for failed Tavus training.
  • Improved Persona UploadEnhanced video upload limits and error handling for better user experience.
  • AI Mode ToggleIntroduced explicit toggle for AI mode to take over human heartbeat signals.
  • User-Friendly UIRevamped portal editor layout to improve accessibility and usability.
  • Teleprompter OverlayAdded a teleprompter overlay to the persona recorder for better user guidance.

My goal today was improving user experience and addressing issues related to the Tavus video personas and the AI portal. I worked for 21 hours and completed 19 tasks related to settings, persona, and deployment updates. Major updates include an admin invocation for refunds, error handling, and an overall better experience for users uploading persona videos.

An example of a significant addition is the admin invocation for refunds, and I designed an interface along with an endpoint for automatic refunds when Tavus training fails. User frustration was highlighted when there were no clear next steps after failed Tavus training sessions. Additionally, I prioritized failure reasons being more visible on the persona page. To facilitate this, I explored the Tavus API to provide users with clear and polite messages when issues were encountered.

Along with the refund mechanism, I added a toggle that allows AI mode to be prioritized over human heartbeat signals. With this, I aimed to provide a more intuitive experience, especially since the AI portal became accessible to anonymous visitors, and sign-in requirements were removed, increasing portal accessibility.

I didn’t stop improving the UI there. I overhauled the portal editor so that pills will now show in a full-width four-column grid allowing users to access all features without obstruction. For better usability, I compacted the portal editor toggle pills to fit on a single row which took a good amount of CSS to avoid clipping on smaller panels. These changes were important for cleaning up the interface and demonstrating my commitment to improvement.

The persona video upload feature posed a specific challenge for me. Initially, the production logs showed requests were failing due to exceeding the 10 MB limit. To resolve this, I increased the Next.js middleware body cap to 256 MB to allow for better quality video uploads while also improving error communication to users. Now, when a video is uploaded that exceeds the limit, the system provides an informative 413 response in addition to document format guidance to the user. This portion of the day was extremely tedious, especially with all of the testing I had to do.

Changing the persona recorder user experience was another improvement I made. I added a teleprompter overlay that limits how tall the video preview can be so users do not become distracted by a messy interface. The overlay also features a Tavus consent line which makes it apparent that verbal consent is required for recording. I’m very happy with how this turned out and it was a necessary step for user reassurance and compliance.

I'm still working on backend improvements. I fixed the issues with the Tavus video persona recording formats. I had to change some of the settings for MediaRecorder to maintain good quality recordings and also handle errors from the Tavus API to provide better feedback to users. This was complicated and required a lot of testing, but I am happy to say that the video recording process is stable and more accessible than before. \

At the end of the day, I feel a mix of pride and fatigue. I have built all of this agentic web platform almost completely myself with some help from Claude on the code in VS Code. I still believe in the vision, and the work I did today gives me more confidence. Every feature I add puts me closer to the ideal of running a one-man company with a billion-dollar valuation. The bugs I dealt with were infuriating, but they will be critical to my learning going forward. It has been great to see the impact of these new features on user engagement and satisfaction as I have continued building out the functionality on hashtag.org.

← Back to the full build journal