Metadata-Version: 2.4
Name: rokovo
Version: 0.1.0
Summary: Rokovo CLI
Project-URL: Homepage, https://rokovo.io
Project-URL: Repository, https://github.com/dezh-tech/rokovo-cli
Project-URL: Issues, https://github.com/dezh-tech/rokovo-cli/issues
Author-email: Rokovo <info@rokovo.io>
License: MIT
License-File: LICENSE
Keywords: agents,ai,ai-agents,cli,langchain,rokovo
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Requires-Dist: chromadb
Requires-Dist: jinja2
Requires-Dist: langchain
Requires-Dist: langchain-community
Requires-Dist: langchain-core
Requires-Dist: langchain-openai
Requires-Dist: sentence-transformers
Requires-Dist: typer
Provides-Extra: dev
Requires-Dist: build>=1.2.1; extra == 'dev'
Requires-Dist: ruff>=0.4.2; extra == 'dev'
Requires-Dist: twine>=5.1.1; extra == 'dev'
Description-Content-Type: text/markdown

# Rokovo CLI

<p align="center">
  <img src="assets/logo.png" alt="Rokovo CLI Logo" width="300">
</p>

The Rokovo CLI brings a simple AI agent on your command line to help you with documenting pure source codes for both developers and end users.

## Quick Start

You can install the CLI using PIP:

```sh
pip install rokovo
```

To extract FAQs from your codebase, run the following command:

```sh
rokovo --context-dir ./context.md --root-dir ./path/to/project --api-key <your-openrouter-api-key>
```

>[!NOTE]
> If you wan to lookup more commands take a look at `rokovo --help`.

### Context file

Context file is a markdown file that contains a high level description of your project. This will help the AI agent to understand the project better and generate more accurate documentation. A basic model of writing a context file is as follows:

1. Project name and a brief description.
2. Project structure and important files.
3. Important keywords and terminologies.
4. A set of questions as example to help agent with finding questions and answers.

An example context file can be found on [examples_context.md](./examples_context.md).

## LLM

We use the OpenRouter API as default and you can use `--api-key` flag to pass your API key. If you are using another provider feel free to pass ``--base-url` and `--model` flags to configure your provider.

Any provider compatible with OpenAI API is accepted and you can use local models too.

## License

MIT License - see [LICENSE](./LICENSE).
