Metadata-Version: 2.4
Name: bitcraft
Version: 0.1.0
Summary: Bitcoin transaction intelligence in your terminal: ranked alerts, evidence and link analysis.
Author: Rohan Pattanayak, Jagadish Pattnaik, Shreya Mishra, Shreya Mohanty, Ashutosh Badapada, Rosalin Nayak
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/RohanOnKeys/bitcraft
Project-URL: Source, https://github.com/RohanOnKeys/bitcraft
Project-URL: Documentation, https://github.com/RohanOnKeys/bitcraft/blob/main/docs/user_manual.md
Project-URL: Issues, https://github.com/RohanOnKeys/bitcraft/issues
Keywords: bitcoin,aml,fraud-detection,graph,tui,textual
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: textual>=5.0
Requires-Dist: httpx>=0.27
Requires-Dist: pillow>=10.0
Provides-Extra: dev
Requires-Dist: pytest>=8.3; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Dynamic: license-file

# BitCraft

Bitcoin transaction intelligence in your terminal: ranked alerts,
provenance-tagged evidence, SHAP reasons, wallet clustering and an animated
link-analysis view.

![BitCraft dashboard](https://raw.githubusercontent.com/RohanOnKeys/bitcraft/main/docs/images/dashboard.png)

## Install

```text
pipx install bitcraft         # recommended: isolated install of the CLI
pip install bitcraft          # any OS, Python 3.10+
choco install bitcraft        # Windows, via Chocolatey
```

## Use

```text
bitcraft                 open BitCraft in a new, large terminal window
bitcraft demo            same, with built-in demo data
bitcraft here            run inside the current terminal
bitcraft status          check the API and the last pipeline run
bitcraft --help          everything else
```

BitCraft connects to a BitCraft API at `http://localhost:8000` (change it
with `--api-url` or `BITCRAFT_API_URL`) and falls back to demo data when
none is running. The API and ML pipeline live in the
[source repository](https://github.com/RohanOnKeys/bitcraft).

Best in Windows Terminal, a modern Linux terminal or iTerm2, at 160x46 or
larger.

| Wallets | Alert detail |
| --- | --- |
| ![Wallets](https://raw.githubusercontent.com/RohanOnKeys/bitcraft/main/docs/images/wallets.png) | ![Alert detail](https://raw.githubusercontent.com/RohanOnKeys/bitcraft/main/docs/images/detail.png) |

## License

Apache License 2.0. Copyright 2026 The BitCraft Authors: Rohan Pattanayak,
Jagadish Pattnaik, Shreya Mishra, Shreya Mohanty, Ashutosh Badapada and
Rosalin Nayak.
