writeme.md is an automated tool designed to generate README.md files by analysing the code in your codebase. It leverages the power of autogen, a framework that deploys AI agents to create a custom, informative README.md based on the specific contents and structure of your project.
The tool is built on a microservice architecture using Kubernetes and Docker to manage and scale its various components. RabbitMQ is used as the message broker for handling task queues, while MongoDB stores information about processed requests, including generated README.md files and repository data.
Currently, it only works on Python files.
WIP - host on GCP
Clone the repo:
git clone git@github.com:WDoyle123/writeme.md.git
cd writeme.md
Add the following entry to your /etc/hosts file:
127.0.0.1 writeme.com
To enable notification features, you will need to create a Gmail account and configure it as follows:
- Generate a pass key for your Gmail account.
- Add this key to the file located at:
manifest/notifications/readme-notifications-secret.yaml
Ensure you have the following dependencies installed:
- Minikube
- Docker
- Kubernetes
After verifying the prerequisites, navigate to the scripts directory and run the setup.sh script to configure the environment:
cd scripts
./setup.shThere are some areas for improvement but writeme.md provides a solid base for the user to make final changes.
Tuits is a command-line interface (CLI) tool designed for task management. It allows users to log tasks, track their workday, and generate summaries of their productivity over specified time frames. The application supports various functionalities including starting and finishing workdays, logging tasks with optional messages, displaying tasks based on different time frames (day, week, month, year), managing database backups, and generating task summaries.
To set up the Tuits application, follow these steps:
-
Clone the repository:
git clone https://github.com/wdoyle123/tuits.git cd tuits -
Install dependencies: Ensure you have Python installed, then install the required packages:
pip install -r requirements.txt
-
Initialize the database: Run the following command to set up the database:
python tuits.py init_db
-
Run the application: You can start using the application by running:
python tuits.py
Here are some examples of how to use the Tuits application:
-
Start work:
python tuits.py start
-
Log a task:
python tuits.py log "Task Name" -m "Task details"
-
Show tasks for today:
python tuits.py show day
-
Backup the database:
python tuits.py backup save
-
Generate a summary of tasks for the week:
python tuits.py summary week --api_key YOUR_API_KEY
-
Remove a task:
python tuits.py remove
- Python: The primary programming language used for developing the application.
- SQLite: A lightweight database used for storing tasks and logs.
- Command-Line Interface (CLI): The application is designed to be used via the command line, providing a straightforward user experience.
- shutil: A Python module used for file operations, particularly for managing database backups.
This project is a great tool for anyone looking to improve their productivity and keep track of their tasks efficiently.
