MIT ยท Bots

GPT-Shell

Open-source Discord AI companion with ChatGPT-style conversations and image generation, evolved into Erin.

0.2K stars 0.0K forks MIT license 2026-06-05 verified
bash
$# GPT-Shell
$pip install gpt-shell
$npx gpt-shell --help
Open sourceSelf-hostedGUI
Overview

What is GPT-Shell?

GPT-Shell is an open-source AI bot project focused on open-source discord ai companion with chatgpt-style conversations and image generation, evolved into erin.

Lives in existing communication channels

GPT-Shell brings AI assistance into messaging surfaces rather than forcing users into a separate app.

Bots become useful when they meet users where coordination already happens.

Self-hostable source path

The public repository lets teams inspect runtime behavior, credentials handling, and integration choices before deployment.

AI bots can see sensitive conversations, so source review and controlled hosting matter.

Good comparison target for agent gateways

The project shows how open bots connect LLMs, permissions, plugins, memory, or channel adapters.

These patterns are likely to become a core part of practical open-agent infrastructure.
Use cases

What teams use it for

Team chat AI assistant

Deploy or study GPT-Shell as a starting point for AI help inside messaging channels.

Personal always-on bot

Evaluate whether its channel support, model support, and hosting model fit a private personal assistant workflow.

Agent gateway prototype

Use the project to compare how bots handle message routing, model calls, plugins, and long-running tasks.

Ecosystem

Tags & capabilities

botopen sourcemessagingchat uiopen sourceself hosted
Integrations
DiscordOpenAI
Comparison

How it stacks up

When to choose GPT-Shell

Choose it when its official repository shows the workflow, license, and integration model you need more directly than a broad framework.

FAQ

Questions

Is GPT-Shell open source?

Yes. The linked GitHub repository lists MIT licensing information; verify the current license before production use.

Who should evaluate GPT-Shell?

Builders evaluating self-hosted AI bots for real messaging channels

Decision brief

Should you use GPT-Shell?

JSON
Best for
  • Builders evaluating self-hosted AI bots for real messaging channels
  • Teams comparing Discord, Telegram, Slack, WhatsApp, Matrix, or WeChat AI assistant options
  • Developers who want open-source bot infrastructure instead of closed chatbot SaaS
Not for
  • Teams unwilling to review bot permissions, channel credentials, and data retention policies
  • Users who only need a hosted consumer chatbot with no deployment work
Trust and freshness
  • Verified 2026-06-05
  • License: MIT
  • Repo: firtoz/GPT-Shell
  • Open-source signal
Deployment

self hosted, cloud

Permission surface

shell/files, messages

Decision signals

Self-hostable, GUI

Agent packet

Structured decision data for GPT-Shell

This packet is the compact machine-readable view agents should use before following source links or taking action.

Capabilities

messaging, chat ui

Constraints

open source, self hosted

Deployment

self hosted, cloud

Permission surface

shell/files, messages

Recommended workflows

self hosted ai, chatbot

Overview

What GPT-Shell does

What it is

GPT-Shell is an open-source AI bot project tracked by OpenAgent.bot. GPT-Shell is an open-source AI bot project focused on open-source discord ai companion with chatgpt-style conversations and image generation, evolved into erin.

Why it matters

GPT-Shell matters because many useful agents will not live only inside an IDE or web app. They need to work inside the communication channels people already use, with source code that can be inspected, self-hosted, and adapted around privacy, permissions, memory, and operational controls.

How to evaluate it

Open the official repository first, review setup instructions, verify the license, then test the project with non-sensitive data before connecting real accounts or production workflows.

Facts

Known metadata and operating surface

These fields are separated from editorial interpretation so agents can reason over facts and missing checks.

Resource type bot
Category Bots
Maturity active
Difficulty Unknown
License MIT
Pricing open source
Verified 2026-06-05
Source confidence medium
Risk level elevated
Fit matrix

Where GPT-Shell fits in an agent stack

partial

Coding agent workflow

GPT-Shell has at least one signal for coding agent workflow, but should be checked against a real task before adoption.

  • Run a small repository change and inspect the diff, tests, and rollback path.
  • Confirm official docs, current maintenance, license, and runtime constraints before production use.
partial

Evaluation and observability

GPT-Shell has at least one signal for evaluation and observability, but should be checked against a real task before adoption.

  • Add one repeatable test case and confirm results can run again in review or CI.
  • Confirm official docs, current maintenance, license, and runtime constraints before production use.
partial

Local or private AI stack

GPT-Shell has at least one signal for local or private ai stack, but should be checked against a real task before adoption.

  • Verify hardware requirements, data path, storage, and whether all calls stay in your environment.
  • Confirm official docs, current maintenance, license, and runtime constraints before production use.
weak

Browser automation

GPT-Shell is not primarily positioned for browser automation in the current metadata.

  • Run one non-sensitive website task and inspect clicks, waits, retries, and changed URLs.
  • Confirm official docs, current maintenance, license, and runtime constraints before production use.
weak

Connector or protocol layer

GPT-Shell is not primarily positioned for connector or protocol layer in the current metadata.

  • Connect one low-risk service, then inspect schemas, auth scope, errors, and logs.
  • Confirm official docs, current maintenance, license, and runtime constraints before production use.
weak

Memory or RAG workflow

GPT-Shell is not primarily positioned for memory or rag workflow in the current metadata.

  • Create, update, retrieve, correct, and delete memory or retrieval objects with real data.
  • Confirm official docs, current maintenance, license, and runtime constraints before production use.
Inputs and outputs

What an agent should inspect

Likely inputs

  • Repositories, files, issues, terminal output, and test results
  • Official setup instructions and a small real workflow

Likely outputs

  • Diffs, commits, explanations, test results, or review notes
  • Scores, traces, regression results, dashboards, or failure cases
  • A decision on whether this resource fits the target workflow
Evidence

Sources, claims, and missing checks

Claims are marked separately from source links so future crawlers and reviewers can update them without rewriting the page.

verified

GPT-Shell is listed as open source.

License metadata: MIT
verified

GPT-Shell has a recorded GitHub repository: firtoz/GPT-Shell.

Resource facts and GitHub source link.
inferred

GPT-Shell supports these recorded deployment modes: self hosted, cloud.

OpenAgent decision signal metadata.
inferred

GPT-Shell is tagged with messaging, chat ui capabilities.

OpenAgent capability taxonomy.
Missing checks
  • Dedicated docs link is missing.
  • Repository freshness has not been recorded.
Next action

How to start evaluating GPT-Shell

Inspect repository

Check license, recent activity, issues, examples, and security-sensitive code paths.

Open source
Compare

Alternatives and nearby resources

Use related resources to compare category fit, license, deployment model, and first-workflow behavior.

FAQ

Common questions about GPT-Shell

Is GPT-Shell open source?

Yes. The linked GitHub repository lists MIT licensing information; verify the current license before production use.

Who should evaluate GPT-Shell?

Builders evaluating self-hosted AI bots for real messaging channels