Skip to content

ReadmeMaker is a project designed to automatically generate custom readable markdown files based on specific attributes and codebase structures. It leverages several internal modules to facilitate this process, enhancing productivity and ensuring consistency across documentation.

License

Notifications You must be signed in to change notification settings

Walon-Foundation/readmeMaker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ReadmeMaker

Description

ReadmeMaker is a command-line tool for generating professional and clean README files, as well as contribution guidelines and licenses, for your projects. By integrating artificial intelligence, ReadmeMaker simplifies the process of maintaining up-to-date documentation, saving you valuable time and effort.

Features

  • Generate README files tailored for different types of projects.
  • Include licenses for open-source projects.
  • Generate contribution guidelines.
  • Support for multiple AI models for generating content.

Installation

  1. Clone the repository:

    git clone github.com/walonCode/readmeMaker
    cd readmeMaker
  2. Install dependencies:

    go get
  3. Set up environment variables:

    Copy .env.example to .env and fill in the required values.

    cp .env.example .env

    Populate .env with your API key and other necessary variables.

Usage

Run the tool using the following command:

go run main.go -projectName <projectName> -model <model> -license <license type> -contribute
  • projectName: The name of the project/repository.
  • model: The AI model to use for content generation.
  • license: The type of license you want to generate.
  • contribute: Option to include contribution guidelines (boolean flag).

Technologies

Technology/Tool Purpose
Go Go Programming Language
godotenv godotenv Loading environment variables
AI Services AI Services Generating project documentation automatically using AI
File Parsing File Parsing Parsing and writing project-related files

Configuration and Environment Variables

  • .env:

    API_KEY=""
    

Folder Structure

.
├── .env
├── .env.example
├── .gitignore
├── cmd
|  ├── contribute.go
|  ├── license.go
|  ├── readme.go
├── go.mod
├── go.sum
├── internal
|  ├── file_parser
|  |  ├── fileParser.go
|  ├── llm
|  |  ├── ai.services.go
|  ├── tree
|  |  ├── buildTree.go
|  ├── types
|  |  ├── types.go
|  ├── utils
|  |  ├── buildPrompt.go
|  |  ├── writeReadme.go
├── main.go

Author

  • walonCode

Feel free to raise an issue or submit a PR if you'd like to contribute to the project.


About

ReadmeMaker is a project designed to automatically generate custom readable markdown files based on specific attributes and codebase structures. It leverages several internal modules to facilitate this process, enhancing productivity and ensuring consistency across documentation.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages