Skip to content

Convert your code snippets into GitHub Flavoured Markdown

License

Notifications You must be signed in to change notification settings

dockersamples/ReadMeAI

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

74 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿค– ReadmeAI ๐Ÿ“ƒ

Untitled-1-01-1.jpg

Visitors ๐Ÿ‘€

JavaScript HTML5 CSS3 NodeJS Express.js Markdown Docker Git GitHub

Overview

The README Generator is a platform that allows users to upload a single-file code and describe their project. The AI generates a Markdown code, which can be edited in real-time using a code editor, and the changes are previewed instantly.

ReadMeAI is now live at readmeai.live

Navigation

๐Ÿ˜Ž Features

  • AI-Powered Content: It uses Google AI to generate meaningful and informative content for your README, including project description, usage, installation, and more.

  • Customization: You can customize the generated content using a built in editor to include or exclude specific sections, ensuring your README reflects your project's unique needs.

  • Markdown Support: The generated README files use Markdown, making it easy to format and style your project documentation.

  • User-Friendly Web Interface: Access the generator through a user-friendly web interface, eliminating the need for manual setup.

๐Ÿ“‚ File Structure (MVC)

  • ๐Ÿ“ api/ : contains code file to connect to third party api's (Google PaLM 2)
  • ๐Ÿ“ controllers/ : Contains all the business logic to execute on post/get requests.
  • ๐Ÿ“ views/ : Contains files to render at client sides.
  • ๐Ÿ“ data/ : Contains the 'template' which will hold the output template and 'output.md' which will output markdown.
  • ๐Ÿ“ public/ : Contains client side css and scripts.
  • ๐Ÿ“ routes/ : File to handle routes and to call respective controller function on particular route.
  • ๐Ÿ“ uploads/ : This directory will hold files that server received from client side, and then deletes them once the session ends.
  • ๐Ÿ“ƒ server.js : This file is the main express server, this is the file that will execute on starting server.
  • ๐Ÿ“ƒ Dockerfile : This file contains script to containerize project.

๐Ÿ’ป Tech Stack

  • ๐Ÿš€ Node.js: Server-side runtime.
  • ๐ŸŒ Express: Node.js framework.
  • ๐Ÿค– Google PaLM API: Google Pathways Language Model is a 540 billion parameter transformer-based large language model.
  • ๐ŸŽจ EJS: Templating engine to render and add dynamic content in your HTML at server.
  • ๐ŸŽจ CSS: Styling the HTML template.
  • ๐Ÿ’ผ JavaScript: To add Interactivity in the frontend.

โš™๏ธ Installation

In Your Local Machine

  1. Clone the repository.
  2. Navigate to the project directory.
  3. Open your terminal and run:
    npm install

In Your Virtual Machine (using Docker)

  1. Clone the repo and navigate to the project directory.
  2. Open the terminal and type the following command:
     docker build -t gitax18/readmeai .

๐Ÿš€ Usage

In your Local Machine

  1. Change to the project directory.
  2. Open your terminal and type the following command:
    npm start
  1. The Application will run on http://localhost:3333

Using Docker Container

  1. To start the container, type the following command:
    docker run -it -p 3333:3333 gitax18/readmeai
  1. Now the Application will run on http://localhost:3333

NOTE: If the project don't run properly and show crbug error in web console then follow following steps.

  1. Open VSCode an go to 'Run and Debug' menu in left sidebar.
  2. Click on 'create a launch.json file' and select node.js in pop-up menu.
  3. Now click on green triangular play icon on the top of same 'Run and Debug' sidebar.
  4. Now go to http://localhost:3333

๐Ÿ”ฎ Features for next release.

  • GitHub Authorization to add repo rather than single file.
  • More trained AI to generate readme for folders rather than file.
  • Custom templates, User can defined what features/section they want in their readme.

๐ŸคSupport

If you encounter any issues or have questions, please feel free to create an issue on the repository. We're here to help!

โœ๏ธ Authors

  • Gitanshu Sankhla (Backend Developer) -

    GitHub-social LinkedIn-social Instagram-social

  • Vijay Banjara (Frontend Developer) -
    GitHub-social LinkedIn-social Instagram-social

  • Harsh Kumar (Designer) -

    GitHub-social Instagram-social

About

Convert your code snippets into GitHub Flavoured Markdown

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 45.7%
  • CSS 35.1%
  • EJS 18.3%
  • Dockerfile 0.9%