Skip to content

Commit f6d8ec0

Browse files
committed
Update project documentation with offline mode example.
1 parent 12fdc62 commit f6d8ec0

File tree

3 files changed

+767
-15
lines changed

3 files changed

+767
-15
lines changed

README.md

Lines changed: 23 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -24,11 +24,10 @@
2424
<img src="https://img.shields.io/badge/GitHub%20Actions-2088FF.svg?style&logo=GitHub-Actions&logoColor=white" alt="actions" />
2525
</p>
2626
<a href="https://pypi.org/project/readmeai/">
27-
<img src="https://img.shields.io/pypi/v/readmeai?color=5D6D7E&logo=pypi" alt="pypi-version" />
28-
</a>
27+
<img src="https://img.shields.io/pypi/v/readmeai?color=5D6D7E&logo=pypi"
28+
alt="pypi-version" /></a>
2929
<a href="https://pypi.org/project/readmeai/">
30-
<img src="https://img.shields.io/pypi/pyversions/readmeai?color=5D6D7E&logo=python" alt="pypi-python-version" />
31-
</a>
30+
<img src="https://img.shields.io/pypi/pyversions/readmeai?color=5D6D7E&logo=python" alt="pypi-python-version" /></a>
3231
<img src="https://img.shields.io/github/commit-activity/m/eli64s/readme-ai.svg?color=5D6D7E" alt="commits-month" />
3332
<img src="https://img.shields.io/github/license/eli64s/readme-ai?color=5D6D7E" alt="license" />
3433
<br>
@@ -377,7 +376,7 @@ This project is under development with an opinionated setup. It's vital to revie
377376
<br>
378377

379378
<p align="right">
380-
<a href="#top"><b>🔝 Return </b></a>
379+
<a href="#top"><b>Return </b></a>
381380
</p>
382381

383382
---
@@ -547,13 +546,13 @@ To generate a *README.md* file, use the `readmeai` command in your terminal, alo
547546

548547
To customize the README file generation process, you can modify the project's [configuration file:](https://github.com/eli64s/readme-ai/blob/main/readmeai/settings/config.toml)
549548

550-
- [*api*](https://github.com/eli64s/readme-ai/blob/main/readmeai/settings/config.toml) - OpenAI language model API configuration settings.
551-
- [*base_urls*](https://github.com/eli64s/readme-ai/blob/main/readmeai/settings/config.toml) - Base URLs for supported remote repository platforms.
552-
- [*cli*]((https://github.com/eli64s/readme-ai/blob/main/readmeai/settings/config.toml) - CLI option settings used by the *readme-ai* application.)
553-
- [*git*](https://github.com/eli64s/readme-ai/blob/main/readmeai/settings/config.toml) - Default git repository settings used if no repository is provided.
554-
- [*paths*](https://github.com/eli64s/readme-ai/blob/main/readmeai/settings/config.toml) - Directory paths and files used by the *readme-ai* application.
555-
- [*prompts*](https://github.com/eli64s/readme-ai/blob/main/readmeai/settings/config.toml) - Large language model prompts used to generate the README file.
556-
- [*md*](https://github.com/eli64s/readme-ai/blob/main/readmeai/settings/config.toml) - Dynamic Markdown section code templates used to build the README file.
549+
- **api**: OpenAI language model API configuration settings.
550+
- **base_urls**: Base URLs for supported remote repository platforms.
551+
- **cli**: CLI option settings used by the *readme-ai* application.
552+
- **git**: Default git repository settings used if no repository is provided.
553+
- **paths**: Directory paths and files used by the *readme-ai* application.
554+
- **prompts**: Large language model prompts used to generate the README file.
555+
- **md**: Dynamic Markdown section code templates used to build the README file.
557556

558557
---
559558

@@ -578,12 +577,22 @@ Using `pip`
578577
readmeai --output readme-ai.md --repository https://github.com/eli64s/readme-ai
579578
```
580579

581-
You can also use the `short flags` for the CLI options above. In this example we are naming the output file `readme-ai.md`, setting the repository URL to the *readme-ai* repository, using the `flat-square` badge style, and removing emojis from the README file header names.
580+
You can also use the `short flags` for the CLI options above.
581+
582+
In this example we name the output file `readme-ai.md`, set the repo URL to *readme-ai*, use the `flat-square` badge style, and remove emojis from the README file header names.
582583

583584
```bash
584585
readmeai -o readme-ai.md -r https://github.com/eli64s/readme-ai -b flat-square -e false
585586
```
586587

588+
Additionally, you can run readme-ai in offline mode, or without an API key! This option is useful for spinning up a baseline README.md file that still contains your project's metadata.
589+
590+
```bash
591+
readmeai -o readme-ai.md -r https://github.com/eli64s/readme-ai --offline true
592+
```
593+
594+
> Offline mode example [README.md](https://github.com/eli64s/readme-ai/blob/main/examples/markdown/readme-offline.md)
595+
587596
<br>
588597

589598
Using `docker`
@@ -679,7 +688,7 @@ bash scripts/test.sh
679688

680689

681690
<p align="right">
682-
<a href="#top"><b>🔝 Return</b></a>
691+
<a href="#top"><b>Return</b></a>
683692
</p>
684693

685694
---

0 commit comments

Comments
 (0)