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.2.0.tar.gz (6.4 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.2.0-py3-none-any.whl (8.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mdchat-0.2.0.tar.gz
  • Upload date:
  • Size: 6.4 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.2.0.tar.gz
Algorithm Hash digest
SHA256 d99d6b212f2d049ae440f24fda563b3f048376df25d78c6dc23d3ab322086351
MD5 9e2605a3560983d3ed2000cd88561947
BLAKE2b-256 fcd3a9a09b3736aba97b01eae77fd52f8f29a70eea00b6da20ccc365cbffb4f9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: mdchat-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 8.3 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.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 9dc2e5bb795d3a0cf73f708b40b75cebbba8db2282cafeddc0199e22ae93fad5
MD5 82001df28e952429b50fb7ba6c809807
BLAKE2b-256 ce85b97276dc6329ea873630f53e5be9ec4c8f98de07fbab3680fa70812a6e66

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