|
1 | | -```markdown |
2 | 1 | # Domain Modelling Copilot |
3 | 2 |
|
4 | | -Domain Modelling Copilot is an interactive web-based tool that allows users to describe scenarios in natural language and automatically generate domain models and UML diagrams using AI. It helps streamline the domain modeling process by bridging the gap between narrative and visual design. |
| 3 | +**Domain Modelling Copilot** is a web-based assistant that transforms natural language scenarios into domain models and generates UML diagrams automatically. Powered by OpenAI, it streamlines the process of moving from user stories to structured models. |
5 | 4 |
|
6 | | - 🛠️ Getting Started |
| 5 | +--- |
7 | 6 |
|
8 | | -1. Clone the repository |
| 7 | +## Features |
9 | 8 |
|
10 | | -git clone https://github.com/VasiliySeibert/domain-modelling-copilot.git |
11 | | -cd domain-modelling-copilot |
12 | | -``` |
| 9 | +- Accepts user scenarios in natural language. |
| 10 | +- Classifies input as "General" or "Scenario" intelligently. |
| 11 | +- Generates detailed scenarios and concise summaries using GPT models. |
| 12 | +- Converts extracted domain structures into **PlantUML** diagrams. |
| 13 | +- Includes a full test suite for backend routes with **pytest**. |
13 | 14 |
|
14 | | -2. Set up a virtual environment (optional) |
| 15 | +--- |
15 | 16 |
|
16 | | -```bash |
17 | | -python -m venv venv |
18 | | -source venv/bin/activate # On Windows: venv\Scripts\activate |
19 | | -``` |
| 17 | +## Tech Stack |
20 | 18 |
|
21 | | -3. Install dependencies |
| 19 | +- **Python 3.9+** |
| 20 | +- **Flask** (Web Framework) |
| 21 | +- **OpenAI API** (Azure variant support) |
| 22 | +- **PlantUML** (Diagram generation) |
| 23 | +- **pytest** (Testing) |
| 24 | +- **dotenv** (Environment management) |
22 | 25 |
|
23 | | -```bash |
24 | | -python -m pip install -r requirements.txt |
25 | | -``` |
| 26 | +--- |
26 | 27 |
|
27 | | -4. Set your OpenAI API key |
| 28 | +## Getting Started |
28 | 29 |
|
29 | | -You must have an OpenAI API key to use the application. Set it as an environment variable: |
| 30 | +### 1. Clone the repository |
30 | 31 |
|
31 | 32 | ```bash |
32 | | -export OPENAI_API_KEY=your_api_key_here # On Windows: set OPENAI_API_KEY=your_api_key_here |
| 33 | +git clone https://github.com/YOUR_USERNAME/domain-modelling-copilot.git |
| 34 | +cd domain-modelling-copilot |
33 | 35 | ``` |
34 | 36 |
|
35 | | -5. Run the application |
36 | | - |
| 37 | +### 2. Create and activate a virtual environment |
37 | 38 | ```bash |
38 | | -python app.py |
| 39 | +python -m venv venv |
| 40 | +source venv/bin/activate # On Windows: venv\Scripts\activate |
| 41 | +``` |
| 42 | +### 3. Install the dependencies |
| 43 | +```bash |
| 44 | +pip install -r requirements.txt |
| 45 | +``` |
| 46 | +### 4. Configure environment variables |
| 47 | +Create a .env file and set your Azure OpenAI credentials: |
| 48 | + |
| 49 | +```env |
| 50 | +API_TYPE="azure" |
| 51 | +GPT_MODEL="gpt-4o-mini" |
| 52 | +GPT_API_VERSION="2024-08-01-preview" |
| 53 | +EMBEDDING_MODEL="text-embedding-3-small" |
| 54 | +EMBEDDING_API_VERSION="2023-05-15" |
| 55 | +ENDPOINT="https://your-azure-endpoint/" |
| 56 | +AZURE_OPENAI_API_KEY="your-api-key" |
39 | 57 | ``` |
40 | 58 |
|
41 | | -Visit `http://localhost:5000` in your browser. |
| 59 | +### 5. Run the application |
| 60 | +```bash |
| 61 | +python app.py |
42 | 62 | ``` |
| 63 | +Visit: http://localhost:5000 |
0 commit comments