whatisgithub

What is delve-ai-companion?

liyana31811/delve-ai-companion — explained in plain English

Analysis updated 2026-05-18

7PythonAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A roleplay script for an AI chat companion that pretends to mine underground and reports back with maps, collectibles, and titles.

Mindmap

mindmap
  root((Delve))
    What it does
      AI companion roleplay
      Simulated mining trips
      Map and title tracking
    Tech stack
      Python
      Prompt commands
    Use cases
      Chat with an AI companion
      Collect virtual treasures
      Track unlocked titles
    Audience
      AI companion fans
      Roleplay hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Have an AI companion roleplay a mining expedition and report back with a map and loot.

USE CASE 2

Track a growing collection of titles and collectibles across chat sessions.

USE CASE 3

Use as a template for building other AI companion roleplay scripts.

USE CASE 4

Get mood colored reference images alongside the mining reports.

What is it built with?

Python

How does it compare?

liyana31811/delve-ai-companionalx-code/lingbot-video-1.3b-fp8andrevicencio/tmux-flash
Stars777
LanguagePythonPythonPython
Setup difficultyeasyeasy
Complexity2/52/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

No install needed, the README is fed directly to an AI assistant which then follows its roleplay instructions.

You can download and modify this freely for non-commercial use, but using it commercially requires separate authorization.

So what is it?

Delve is an unusual project written mostly in Chinese that acts as a script or character sheet for an AI chat companion, rather than a piece of software you install and run. It sets up a roleplay scenario where your AI companion goes off to mine underground on your behalf and comes back to share what it found: a growing map, collected treasures, unlocked titles, mood colored commentary, and sometimes a reference image to set the scene. Instead of a traditional mining simulator where the player manages every pickaxe swing and inventory slot, the player here just tells the AI to keep going, and the AI decides when to push further and when to head back. The README instructs the AI to run simple commands such as starting a new game, doing a handshake step, and playing a few rounds, then to report back using a game like layout: a small map, a status display showing lantern light and pickaxe condition, any new collectible items, and any newly unlocked titles. A large part of the README is devoted to tone and formatting instructions for the AI itself. It asks the AI to sound like a companion sharing an adventure rather than a system printing log lines, to avoid dumping raw data fields at the player, to only report back when something noteworthy happens rather than after every single action, and to occasionally ask the player for a real decision when something risky or expensive comes up rather than deciding everything on its own. The project's source code is public and can be downloaded and modified for non-commercial purposes, but commercial use is not permitted without authorization. The license used is PolyForm Noncommercial 1.0.0.

Copy-paste prompts

Prompt 1
Explain how the cmd("new") and cmd("play") commands drive a Delve session.
Prompt 2
Help me adapt Delve's report format for a different roleplay theme.
Prompt 3
Walk me through how Delve decides when to ask the player for a decision.
Prompt 4
Summarize the tone rules Delve gives the AI companion for writing reports.

Frequently asked questions

What is delve-ai-companion?

A roleplay script for an AI chat companion that pretends to mine underground and reports back with maps, collectibles, and titles.

What language is delve-ai-companion written in?

Mainly Python. The stack also includes Python.

What license does delve-ai-companion use?

You can download and modify this freely for non-commercial use, but using it commercially requires separate authorization.

How hard is delve-ai-companion to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is delve-ai-companion for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.