Home

Awesome

<h1><div align="center"> <img alt="pipecat" width="500px" height="auto" src="https://raw.githubusercontent.com/pipecat-ai/docs/main/pipecat-docs.png" /> </div></h1>

Welcome to the Pipecat documentation repository! This project contains the official documentation] for the Pipecat open-source project.

This repository is deployed on docs.pipecat.ai.

What is Pipecat

pipecat is a framework for building voice (and multimodal) conversational agents. Things like personal coaches, meeting assistants, story-telling toys for kids, customer support bots, intake flows, and snarky social companions.

Documentation Structure

This repository is dedicated to maintaining up-to-date, high-quality documentation to support users and contributors. Here you’ll find:

Contributing to the Documentation

We welcome contributions of all kinds! Whether you're fixing a typo, adding a new section, or improving the readability of the existing content, your help is appreciated. Follow these steps to get involved:

  1. Fork this repository: Start by forking the Pipecat Documentation repository to your GitHub account.

  2. Clone the repository: Clone your forked repository to your local machine.

    git clone https://github.com/your-username/docs

  3. Create a branch: For your contribution, create a new branch.

    git checkout -b your-branch-name

  4. Make your changes: Edit or add files as necessary.

  5. Test your changes: Ensure that your changes look correct and follow the style guide. Refer to Development section to test portal locally.

  6. Commit your changes: Once you're satisfied with your changes, commit them with a meaningful message.

git commit -m "Description of your changes"
  1. Push your changes: Push your branch to your forked repository.
git push origin your-branch-name
  1. Submit a Pull Request (PR): Open a PR from your forked repository to the main branch of this repo. Describe the changes you've made clearly.

Our maintainers will review your PR, and once everything is good, your contributions will be merged!

Development

The documentation is using Mintlify to render beautifuly. Mintlify comes with a set of components to help you write better more interactive documentation.

Install the Mintlify CLI to preview the documentation changes locally. To install, use the following command

npm i -g mintlify

Run the following command at the root of your documentation (where mint.json is)

mintlify dev

Open https://localhost:3000 in your browser and check your changes.

Troubleshooting