gpt4all/gpt4all-bindings/cli/developer_notes.md
cosmic-snow ee26e8f271
CLI Improvements (#1021)
* Add gpt4all-bindings/cli/README.md

* Unify version information
- Was previously split; base one on the other
- Add VERSION_INFO as the "source of truth":
  - Modelled after sys.version_info.
  - Implemented as a tuple, because it's much easier for (partial)
    programmatic comparison.
- Previous API is kept intact.

* Add gpt4all-bindings/cli/developer_notes.md
- A few notes on what's what, especially regarding docs

* Add gpt4all-bindings/python/docs/gpt4all_cli.md
- The CLI user documentation

* Bump CLI version to 0.3.5

* Finalise docs & add to index.md
- Amend where necessary
- Fix typo in gpt4all_cli.md
- Mention and add link to CLI doc in index.md

* Add docstings to gpt4all-bindings/cli/app.py

* Better 'groovy' link & fix typo
- Documentation: point to the Hugging Face model card for 'groovy'
- Correct typo in app.py
2023-06-23 12:09:31 -07:00

1.0 KiB

Developing the CLI

Documentation

Documentation can be found in three places:

  • app.py docstrings & comments
  • a Readme: gpt4all-bindings/cli/README.md
  • the actual CLI documentation: gpt4all-bindings/python/docs/gpt4all_cli.md

The docstrings are meant for programmatic use. Since the CLI is primarily geared towards users and not to build on top, they're kept terse.

The Readme is mostly meant for users and includes:

  • a link to the CLI documentation (on the website)
  • a Quickstart section with some guidance on how to get started with a sane setup

The CLI documentation and other documentation are located in the above mentioned docs/ folder. They're in Markdown format and built for the website. Of the three, they should be the most detailed.

Versioning

The version number should now follow the gpt4all PyPI package, so compatibility is more clear.

The one place to change it is the namedtuple called VERSION_INFO.