Skip to main content

a CLI that lets you chat with your markdown notes

Project description

MDChat

Tests

A CLI tool that allows you to chat with your markdown notes. MDChat uses a large language model (LLM) and a method called "Retrieval Augmented Generation" to allow you to have intelligent conversations with an expert on your content.

The primary goal of this project is to be both easy to get started with and educational to what modern AI systems can achieve. There are lots of tools like this out there but, in my opinion, they get a bit too into the weeds on the tech or require too much setup.

Getting started

TODO: write this after you have the package up on pypi

Key Features

  • Allows you to "chat" with any folder of markdown files.
  • Answers will include "sources" to the notes used in generating them.
  • summarizing the most recent notes on a certain topic (given your notes are dated)
  • summarizing what you've been working on in the last day, or week (given your notes are dated)
  • Making novel connections on topics you previously hadn't thought were related

Contributing

MDChat is open-source and open to contributions! if you're looking to contribute to this project please:

  • Create an issue to discuss your idea
  • Fork this repo
  • Create a new branch for your change
  • Make the chnage discussed in your issue
  • Send a pull request

Installing dependencies

poetry lock
poetry install

Running the CLI during development

poetry run mdchat <your-command>

Running tests

poetry run pytest

License

MDChat is released under the MIT License

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mdchat-0.1.0.tar.gz (6.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mdchat-0.1.0-py3-none-any.whl (7.8 kB view details)

Uploaded Python 3

File details

Details for the file mdchat-0.1.0.tar.gz.

File metadata

  • Download URL: mdchat-0.1.0.tar.gz
  • Upload date:
  • Size: 6.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.10.12 Linux/5.15.133.1-microsoft-standard-WSL2

File hashes

Hashes for mdchat-0.1.0.tar.gz
Algorithm Hash digest
SHA256 2fc18c4d0d8026546462f1e1883d08a218b3adf880d3d88a9e6d0d7327398adb
MD5 cfb63de9873a5a07c9ddc87907417226
BLAKE2b-256 2f14649ab9b25afb11a259892eb22bfaa24a5e875d36c0e5466b7820ce465c32

See more details on using hashes here.

File details

Details for the file mdchat-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: mdchat-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 7.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.10.12 Linux/5.15.133.1-microsoft-standard-WSL2

File hashes

Hashes for mdchat-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b4b9a8ba9e6a8cf43479a7fdb605398a4d82558899032c702dfeff6bac841d17
MD5 e3be13fed85b1d2081a7ba36bb19900c
BLAKE2b-256 927eb960baf7b41f24ee1e202cd935a5a237e6622801087718028fe630c95ff1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page