panko-gpt

panko-gpt

Docker app from dracon's Repository

Overview

AI Bot Platform - Easy GPT bot creation for Whatsapp, Discord, Telegram and soon other platforms. Features: Vector Search (RAG), Easy management via UI.

PankoGPT - AI Companion Platform Beta Docker License

Currently in alpha

Create your own unique AI Companions on Discord, Telegram, WhatsApp and soon other platforms.

🚀 Overview

Create and Deploy AI Companions for your friends, and/or family across various messaging platforms, starting with WhatsApp, Discord and Telegram. With PankoGPT, you can:

  • Easily Create Custom AI Companions: Deploy companions with specific goals and behaviors tailored to each need.
  • Customizable Settings: Configure companion behavior by filling out straightforward forms—no coding required.
  • Contextual Understanding: Define the scope and context in which your companion operates.
  • Function Tools: Equip your companions with configurable tools like URL access, time fetching, and more.

Screenshots

Homepage

Homepage - Companion list

Create new companion platform selection

Companion creation form

Create new discord companion form

Companion vector search

Knowledgebase section

Companion functions

Selecting Function/Tools

Companion functions

Settings

Companion functions

Features Features

  • User-Friendly Interface: Deploy custom companions for WhatsApp, Discord and Telegram (and soon other platforms) without the need for deep technical knowledge of their integration.
  • Customizable Behavior: Fine-tune your companions' responses and actions using simple forms.
  • Contextual Companions: Create companions that understand and respond based on context, enhancing their utility.
  • Configurable Tools: Extend your companion’s capabilities with additional functions, such as internet access, time-based responses, etc.

Planned Features Planned Features (or already WIP)

  • Expanded Functionality: More tools to enhance GPT companion capabilities.
  • Skill Development: Pre-built skills for teaching, language practice, coding assistance, and more.
  • Vector Search Optimization: Transition vector search from Atlas Cloud to local PostgreSQL for better performance.

Prerequisites Prerequisites

Before you begin, ensure you have met the following requirements:

  • Docker
  • WhatsApp, Discord and/or Telegram account
  • OpenAI account
  • MongoDB (Cloud version with a free tier available here)

📝 Installation

To install and run the application locally, follow these steps:

  1. Clone the repository:

    git clone https://github.com/catalinberta/panko-gpt.git
    
  2. Navigate to the project directory:

    cd panko-gpt
    
  3. Rename .env.example to .env

  4. Rename .env.dev.example to .env.dev

  5. Fill in the missing environment variables (e.g. Atlas credentials, OpenAI key etc.) in .env and .env.dev.

For Development For Development

  1. Build the development environment:

    docker compose build development
    
  2. Start the development environment:

    docker compose up development
    

For Production For Production

  1. Build the production environment:

    docker compose build production
    
  2. Start the production environment:

    docker compose up production
    

Running the Application Running the Application

Community Community

Discord

Join the Discord community to connect with other users, share ideas, and get support.

⭐️ Other links

🤝 Contributing

Contributions are very welcome! Whether it's adding new features, improving documentation, or reporting bugs, please feel free to make a pull request or open an issue.

📃 License

This project is licensed under the MIT License.

Media gallery

1 / 4

Install panko-gpt on Unraid in a few clicks.

Find panko-gpt in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for panko-gpt Review the template variables and paths Click Install

Categories

Download Statistics

2,561
Total Downloads

Related apps

Explore more like this

Explore all

Details

Repository
catalinbertadev/panko-gpt:latest
Last Updated2025-10-08
First Seen2024-04-26

Runtime arguments

Web UI
http://[IP]:[PORT:5002]
Network
bridge
Shell
sh
Privileged
false

Template configuration

PORTPorttcp
Target
5002
Value
5002
MONGO_ATLAS_PUBLIC_KEYVariable

You can use the free tier from MongoDB Atlas

MONGO_ATLAS_PRIVATE_KEYVariable

IMPORTANT: Ensure the API Keys have 'Organization Owner' permissions (tutorial how to obtain these keys: https://tinyurl.com/25tesjpn)

MONGO_ATLAS_PROJECT_IDVariable

You can find the Project ID in the url after you log into the atlas cloud account and selecting the project. e.g. https://cloud.mongodb.com/v2/PROJECT_ID_HERE#/overview

MONGO_ATLAS_CLUSTER_NAMEVariable

e.g. the name of the cluster you set when you first created the MongoDB account

MONGO_ATLAS_DB_NAMEVariable

(Optional) if not specified, pankogpt will be used

GLOBAL_OPEN_AI_KEYVariable

(Optional) but recommended to help pull certain info like all available models

DATAPathrw

Container Path: /usr/src/backend/data

Target
/usr/src/backend/data
Default
/mnt/user/appdata/panko-gpt/data
Value
/mnt/user/appdata/panko-gpt/data