explaingit

welliv/btcrecover-skill

Analysis updated 2026-05-18

0ShellAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

An AI assisted layer built on top of the btcrecover tool to help guide people through recovering lost Bitcoin wallet passwords or seed phrases.

Mindmap

mindmap
  root((btcrecover-skill))
    What it does
      AI layer
      Wraps btcrecover
      Guides recovery
    Tech stack
      Shell install script
      Ollama
      Hermes model
    Use cases
      Wallet recovery
      Local AI setup
      Community reports
    Audience
      Bitcoin holders
      General users
    Setup
      One line install
      Optional local model

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

Get AI guided help attempting to recover a lost Bitcoin wallet password or seed phrase.

USE CASE 2

Run local recovery attempts using Ollama and a Hermes model instead of a cloud service.

USE CASE 3

Report a successful or failed recovery attempt to help improve the shared guides.

What is it built with?

ShellOllama

How does it compare?

welliv/btcrecover-skill123satyajeet123/bitnet-serveralexbloch-ia/legal-data
Stars000
LanguageShellShellShell
Setup difficultymoderateeasymoderate
Complexity3/52/52/5
Audiencegeneraldevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Local recovery setup requires installing and configuring Ollama with a specific model.

You can use and modify the code, but if you distribute it or a modified version, you must also release the source under the same GPL license.

In plain English

Btcrecover-skill describes itself as an AI layer built on top of an existing tool called btcrecover, created by 3rdIteration. Btcrecover is a program people use to try to recover access to a Bitcoin wallet when they have lost or forgotten part of their password or seed phrase. This project's stated goal is to make that recovery process easier to use by adding an AI assisted layer on top of the original tool. The README is short and mostly acts as a table of contents pointing to other files in the repository rather than explaining the project in depth. It links to a PROJECT.md file for a fuller overview, a SKILL.md file described as the AI orchestrator and the recommended starting point, a guide for setting up local recovery using Ollama and a model called Hermes, and a folder of agent specific install guides. It also links to files about security disclosure policy, an authenticity anchor document, and a legal disclaimer. Installation is done by running a single shell command that downloads and runs an install script directly from the repository. The project also has a community section inviting people to report successful recoveries or problems through GitHub Discussions, noting that these reports should only include the wallet type and scenario, not sensitive data like passwords or seed phrases. Beyond this structure, the README does not explain in detail how the AI layer works, what specific recovery methods it supports, or how it differs technically from the original btcrecover project. The project is released under the GPL-2.0 license and is described as free and open source.

Copy-paste prompts

Prompt 1
Walk me through installing btcrecover-skill using its install script.
Prompt 2
Explain what SKILL.md does as the AI orchestrator for this project.
Prompt 3
Help me set up local Bitcoin wallet recovery with Ollama and Hermes per the guide.
Prompt 4
What should I include, and avoid including, in a recovery report for this project?

Frequently asked questions

What is btcrecover-skill?

An AI assisted layer built on top of the btcrecover tool to help guide people through recovering lost Bitcoin wallet passwords or seed phrases.

What language is btcrecover-skill written in?

Mainly Shell. The stack also includes Shell, Ollama.

What license does btcrecover-skill use?

You can use and modify the code, but if you distribute it or a modified version, you must also release the source under the same GPL license.

How hard is btcrecover-skill to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is btcrecover-skill for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.