Panotti was made by AI! Learn about AI in software development on our Substack — Practical insights on leveraging AI in modern development workflows.

Getting Started with Panotti

Introduction

Welcome to Panotti! This guide will help you get up and running with our platform quickly and efficiently.

Overview

Panotti consists of two main components that can work together or independently:

1. Panotti App

A powerful desktop application that captures both microphone and system audio. The app can trigger webhook callbacks to any API endpoint at the start and end of recordings, making it highly flexible for integration with your existing systems.

2. Backend Server

An open-source server that processes audio to generate transcripts and meeting notes. It features a plugin architecture that allows you to create custom plugins to extend its functionality according to your needs.

While both components can be used independently, we recommend using them together for the best experience and easiest setup. The integrated solution provides a seamless workflow from audio recording to processed meeting insights.

Minimum Prerequisites

  • MacOS 15.2 (Sequoia)
  • 10 GB of free disk space

Quick Start

Panotti Setup Guide

Panotti is an audio capture and processing assistant that allows you to control your data while processing audio on your local machine. This guide will walk you through setting up both the Mac OS desktop app and the Panotti server.

1. Download and Install the Panotti App

Visit the Website

Download the App

  • Click the Download on the Mac App Store button.
  • This will redirect you to the App Store.
  • Download and install the Panotti application.

Launch the App

  • Open the Panotti app.
  • You will see a welcome screen asking you to confirm:
    • You are over 16 years old.
    • You agree with the Terms and Conditions.
    • You agree with the Privacy Policy.

Note: Read the policies on the website and ensure you comply with all local laws and obtain consent for any recordings.

2. Configure System Permissions

Enable Microphone Access

  • When prompted, allow the app to access your microphone.
  • You might need to quit and reopen the app after granting permission.

Enable System Audio Recording

  • Enable system audio recording in your Mac settings.
  • You may need to authenticate using your password or Touch ID.
  • Reopen the app one final time.
  • When the Press to Record button appears, you are ready to proceed.

3. Adjust App Settings

Set Recording Location

  • Navigate to the Call Back screen and ensure it's empty.
  • Click on Settings.
  • Choose your preferred recording location:
    • For example, create a new folder called Panotti in your Documents directory.
  • Click Create and select that folder.

Configure Audio & Transcription Settings

  • Set your audio input to the system default.
  • Under transcription labels, enter the name for your microphone (e.g., Your Name) and leave system audio as Default.

Select Server Installation Location

  • In the settings, click on Choose under server installation.
  • Select your home directory or another folder of your choice.

Change the API Key

  • Replace the default API key with your own unique key (e.g., use a strong key like qwerty123 as an example, but make sure to choose something more secure).

4. Install the Panotti Server

Initiate Server Installation

  • Click on Install a Server.
  • The installation command will be copied to your clipboard.

Run the Installation Command

  • Open your Terminal.
  • Paste the command (using ⌘ + V or via the Edit > Paste menu).
  • Press Enter.
  • You will be prompted to confirm the installation.

Warning: The installation will install Homebrew (a Mac package manager), Ollama (for serving local large language models), and Docker (for backend services).

  • Review the details, then type yes to proceed.

Wait for the Installation to Complete

  • The server installation will set up the Docker container and run the server.
  • This process may take a few minutes.

Verify Server Setup

  • Once the installation is complete, check the admin site (refer to additional documentation for server details).
  • Go to the Callbacks screen in the Panotti app.
  • Ensure that the two required endpoints are added:
    • If not, click the server button to Load Server Defaults (ensure that the X API key matches the one you set earlier).

5. Record and Process Audio

Start a Recording Session

  • In the app, click the Record button.
  • Begin your recording (e.g., a meeting scenario with dialogue).

Stop Recording

  • When finished, click the Stop Recording button.
  • The audio is sent to the server for processing.

Review Processed Files

  • The server cleans the audio, transcribes the content, and generates meeting notes.
  • Find these files in the folder where you installed your server:
    • Look in the data folder for cleaned audio, transcription files, and a Markdown file containing meeting notes.
    • Open the Markdown file (for example, using MacDown) to review the meeting notes and summary.

6. Additional Resources and Support

Documentation

For more detailed instructions, server configuration, and Google Calendar integration, visit the documentation section on the Panotti website.

Support

  • Join the Panotti Discord Community for updates, direct support, and announcements.
  • Alternatively, use the Contact Us link on the website.

Join Our Community

Need help or want to connect with other Panotti users? Join our Discord community for support, discussions, and updates.

Join Discord