{"id":24206437,"url":"https://github.com/mfoud444/uml-ai-generator","last_synced_at":"2026-05-12T14:05:28.230Z","repository":{"id":270903168,"uuid":"911797683","full_name":"mfoud444/UML-AI-Generator","owner":"mfoud444","description":"The AI-Powered UML Diagram Generator is an advanced web application that leverages artificial intelligence to simplify and enhance the creation of professional UML diagrams. Built using the Flask framework and integrated with the g4f AI API, this tool transforms user inputs into high-quality UML diagrams instantly and efficiently.","archived":false,"fork":false,"pushed_at":"2025-01-04T00:48:22.000Z","size":1041,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-14T00:35:14.896Z","etag":null,"topics":["ai","chatgpt","diagram","diagrams","diagrams-as-code","flask","flask-application","g4f","gpt","plantuml","tailwindcss","uml","uml-diagram"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mfoud444.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-03T21:55:33.000Z","updated_at":"2025-01-04T00:48:25.000Z","dependencies_parsed_at":"2025-01-03T23:33:17.246Z","dependency_job_id":null,"html_url":"https://github.com/mfoud444/UML-AI-Generator","commit_stats":null,"previous_names":["mfoud444/uml-ai-generator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mfoud444%2FUML-AI-Generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mfoud444%2FUML-AI-Generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mfoud444%2FUML-AI-Generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mfoud444%2FUML-AI-Generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mfoud444","download_url":"https://codeload.github.com/mfoud444/UML-AI-Generator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241678157,"owners_count":20001682,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","chatgpt","diagram","diagrams","diagrams-as-code","flask","flask-application","g4f","gpt","plantuml","tailwindcss","uml","uml-diagram"],"created_at":"2025-01-14T00:32:23.314Z","updated_at":"2026-05-12T14:05:23.193Z","avatar_url":"https://github.com/mfoud444.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv id=\"top\"\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./logo.jpeg\" alt=\"UML AI Generator\" width=\"300px\" height=\"300px\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eGenerate UML diagrams effortlessly with AI-powered automation and Flask integration.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/mfoud444/UML-AI-Generator/actions\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/mfoud444/UML-AI-Generator/ci.yml?logo=githubactions\u0026label=CI\u0026logoColor=white\u0026color=4169E1\" alt=\"Github Actions\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/mfoud444/UML-AI-Generator\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/mfoud444/UML-AI-Generator?logo=GitHub\u0026logoColor=white\u0026label=Version\u0026color=5D4ED3\" alt=\"GitHub Release\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/mfoud444/UML-AI-Generator?logo=opensourceinitiative\u0026logoColor=white\u0026label=License\u0026color=8A2BE2\" alt=\"MIT License\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003c/div\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/eli64s/readme-ai/eb2a0b4778c633911303f3c00f87874f398b5180/docs/docs/assets/svg/line-gradient.svg\" alt=\"line break\" width=\"100%\" height=\"3px\"\u003e\n\n# UML Diagram Generator Web Application\n\n**[Quick Link to Repository](https://github.com/mfoud444/UML-AI-Generator.git)**  \n\nGenerate professional UML diagrams in seconds! This web application uses Flask and the g4f AI API to automate the creation of UML diagrams. Users can input a project name, select a diagram type, and instantly view the generated diagram in an easy-to-use interface.\n\n---\n\n## Key Features\n\n### 🚀 **User Input Form**\n- **Project Name:** Field to input the project name.  \n- **Diagram Type:** Dropdown menu to select the UML diagram type:\n  - Sequence Diagram\n  - Use Case Diagram\n  - Class Diagram\n  - Object Diagram\n  - Activity Diagram\n  - Component Diagram\n  - Deployment Diagram\n  - State Diagram\n  - Timing Diagram\n\n### ⚙️ **Diagram Generation Workflow**\n- Form submission triggers:\n  1. AI prompt creation based on user input.\n  2. g4f AI API generates PlantUML syntax.\n  3. Syntax is converted into a UML diagram image using PlantUML.\n\n### 🖼️ **Output Display**\n- Generated UML diagram is displayed as an image in the interface.\n\n---\n\n## Screenshots\n\n### 🖼️ Example Interface\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./screenshots/1.png\" alt=\"Application Interface\" width=\"75%\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\u003cem\u003eThe main interface\u003c/em\u003e\u003c/p\u003e\n\n\n### 🖼️ Example Diagram Outputs\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003cimg src=\"./screenshots/2.png\" alt=\"Diagram 1\" width=\"300\" height=\"200\"\u003e\n        \u003cbr\u003e\n        \u003cem\u003eSequence Diagram\u003c/em\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003cimg src=\"./screenshots/3.png\" alt=\"Diagram 2\" width=\"300\" height=\"200\"\u003e\n        \u003cbr\u003e\n        \u003cem\u003eClass Diagram\u003c/em\u003e\n      \u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003cimg src=\"./screenshots/4.png\" alt=\"Diagram 3\" width=\"300\" height=\"200\"\u003e\n        \u003cbr\u003e\n        \u003cem\u003eActivity Diagram\u003c/em\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\u003cp align=\"center\"\u003e\u003cem\u003eSample UML diagrams generated by the application.\u003c/em\u003e\u003c/p\u003e\n\n---\n\n## Implementation Details\n\n### 🛠️ **Technology Stack**\n- **Flask Framework:** Handles routing and rendering.\n- **g4f AI API:** Generates PlantUML syntax based on user input.\n- **PlantUML:** Converts syntax to UML diagram images.\n\n### 💡 **Error Handling**\n- Handles:\n  - Invalid inputs.\n  - API errors or timeouts.\n  - Diagram generation issues.\n\n---\n\n## Requirements\n\n### 🔧 **Setup**\n- Python 3.x  \n- Flask  \n- g4f AI API credentials  \n- PlantUML installed or PlantUML server access  \n\n---\n\n## Installation\n\n1. Clone this repository:  \n   ```bash\n   git clone https://github.com/mfoud444/UML-AI-Generator.git\n   cd UML-AI-Generator\n   ```\n\n2. Install dependencies:  \n   ```bash\n   pip install -r requirements.txt\n   ```\n\n3. Set up g4f AI API credentials.\n\n4. Run the Flask application:  \n   ```bash\n   python app.py\n   ```\n\n5. Access the app at:  \n   `http://127.0.0.1:5000/`\n\n---\n\n## Directory Structure\n\n```\n.\n├── app.py                # Main application file\n├── templates/            # HTML templates\n│   ├── index.html         # Main page template\n├── static/               # Static assets (CSS, JS, images)\n│   └── styles.css         # Custom styles\n├── screenshots/          # Screenshots for documentation\n│   ├── interface.png\n│   ├── output.png\n│   ├── mobile-view.png\n├── requirements.txt      # Dependencies\n└── README.md             # Project documentation\n```\n\n---\n\n## Contributing\n\nContributions are welcome! Follow these steps:  \n1. Fork the repository.  \n2. Create a feature branch:  \n   ```bash\n   git checkout -b feature-name\n   ```  \n3. Commit your changes and push to your fork.  \n4. Submit a pull request.\n\n---\n\n## License\n\nThis project is open-source and licensed under the [MIT License](https://opensource.org/licenses/MIT).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmfoud444%2Fuml-ai-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmfoud444%2Fuml-ai-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmfoud444%2Fuml-ai-generator/lists"}