structured2graph 0.1.1__tar.gz

structured2graph-0.1.1/.env.example

@@ -0,0 +1,52 @@
+# LLM API Configuration (choose one or more)
+# OpenAI
+OPENAI_API_KEY=your_actual_openai_api_key
+
+# Anthropic (Claude)
+# ANTHROPIC_API_KEY=your_actual_anthropic_api_key
+
+# Google (Gemini)
+# GOOGLE_API_KEY=your_actual_google_api_key
+
+# LLM Provider Configuration (optional - auto-detects from available API keys)
+# LLM_PROVIDER: openai, anthropic, gemini
+# LLM_PROVIDER=openai
+# LLM_MODEL=gpt-4o
+# Defaults by provider:
+#   - OpenAI: gpt-4o
+#   - Anthropic: claude-3-5-sonnet-20241022
+#   - Gemini: gemini-2.0-flash-exp
+
+# Migration Defaults (can be overridden via CLI flags)
+# SQL2MG_MODE: automatic, incremental
+SQL2MG_MODE=automatic
+# SQL2MG_STRATEGY: deterministic, llm
+SQL2MG_STRATEGY=deterministic
+# SQL2MG_META_POLICY: auto, reset, skip
+SQL2MG_META_POLICY=auto
+SQL2MG_LOG_LEVEL=INFO
+
+# Source Database Selection
+# SOURCE_DB_TYPE: mysql, postgresql
+SOURCE_DB_TYPE=mysql
+
+# MySQL Database Configuration (used when SOURCE_DB_TYPE=mysql)
+MYSQL_HOST=host.docker.internal
+MYSQL_USER=root
+MYSQL_PASSWORD=your_mysql_password
+MYSQL_DATABASE=sakila
+MYSQL_PORT=3306
+
+# PostgreSQL Database Configuration (used when SOURCE_DB_TYPE=postgresql)
+POSTGRES_HOST=localhost
+POSTGRES_USER=postgres
+POSTGRES_PASSWORD=your_postgres_password
+POSTGRES_DATABASE=postgres
+POSTGRES_PORT=5432
+POSTGRES_SCHEMA=public
+
+# Memgraph Database Configuration
+MEMGRAPH_URL=bolt://localhost:7687
+MEMGRAPH_USERNAME=
+MEMGRAPH_PASSWORD=
+MEMGRAPH_DATABASE=memgraph

structured2graph-0.1.1/.gitignore

@@ -0,0 +1,182 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+
+# VS Code
+.vscode/
+
+
+# Project specfic files
+/enterprise-context/sic-agent/sic-scrapper/output/*

structured2graph-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Memgraph Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

structured2graph-0.1.1/PKG-INFO

@@ -0,0 +1,197 @@
+Metadata-Version: 2.4
+Name: structured2graph
+Version: 0.1.1
+Summary: Database migration agent from structured data (e.g. SQL) to graph.
+Project-URL: Homepage, https://github.com/memgraph/ai-toolkit
+Project-URL: Repository, https://github.com/memgraph/ai-toolkit
+Project-URL: Issues, https://github.com/memgraph/ai-toolkit/issues
+Project-URL: Documentation, https://github.com/memgraph/ai-toolkit/tree/main/agents/sql2graph
+Author-email: Memgraph <tech@memgraph.com>
+Maintainer-email: Memgraph <tech@memgraph.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: database-migration,etl,graph-database,knowledge-graph,memgraph,sql-to-graph
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Database
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: anthropic>=0.40.0
+Requires-Dist: langchain-anthropic>=0.3.0
+Requires-Dist: langchain-core>=1.0.0
+Requires-Dist: langchain-google-genai>=2.0.0
+Requires-Dist: langchain-openai>=0.2.0
+Requires-Dist: langchain>=1.0.0
+Requires-Dist: langgraph>=0.2.0
+Requires-Dist: memgraph-toolbox>=0.1.4
+Requires-Dist: mysql-connector-python>=9.0.0
+Requires-Dist: neo4j>=5.0.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: psycopg2-binary>=2.9
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pymysql>=1.1.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: sqlalchemy>=2.0.0
+Description-Content-Type: text/markdown
+
+# SQL Database to Graph Migration Agent
+
+Intelligent database migration agent that transforms SQL databases (MySQL, PostgreSQL) into graph databases, powered by LLM analysis and LangGraph workflows.
+
+## Overview
+
+This package provides a sophisticated migration agent that:
+
+- **Analyzes SQL database schemas** - Automatically discovers tables, relationships, and constraints
+- **Generates optimal graph models** - Uses AI to create node and relationship structures
+- **Creates indexes and constraints** - Ensures performance and data integrity
+- **Handles complex relationships** - Converts foreign keys to graph relationships
+- **Incremental refinement** - Review each table, adjust the model
+  immediately, then enter the interactive refinement loop once all tables
+  are processed
+- **Comprehensive validation** - Verifies migration results and data integrity
+
+## Installation
+
+```bash
+# Install the package
+uv pip install .
+
+# Or install in development mode
+uv pip install -e .
+```
+
+## Quick Start
+
+Run the migration agent:
+
+```bash
+uv run main
+```
+
+The agent will guide you through:
+
+1. Environment setup and database connections
+2. Graph modeling strategy selection
+3. Automatic or incremental migration mode
+4. Complete migration workflow with progress tracking
+
+> **Incremental review:** The LLM now drafts the entire graph model in a single
+> shot and then walks you through table-level changes detected since the last
+> migration. You only need to approve (or tweak) the differences that matter.
+
+You can also preconfigure the workflow using CLI flags or environment variables:
+
+```bash
+uv run main --mode incremental --strategy llm --meta-graph reset --log-level DEBUG
+```
+
+| Option                                 | Environment          | Description                                                   |
+| -------------------------------------- | -------------------- | ------------------------------------------------------------- |
+| `--mode {automatic,incremental}`       | `SQL2MG_MODE`        | Selects automatic or incremental modeling flow.               |
+| `--strategy {deterministic,llm}`       | `SQL2MG_STRATEGY`    | Chooses deterministic or LLM-powered HyGM strategy.           |
+| `--provider {openai,anthropic,gemini}` | `LLM_PROVIDER`       | Selects LLM provider (auto-detects if not specified).         |
+| `--model MODEL_NAME`                   | `LLM_MODEL`          | Specifies LLM model name (uses provider default if not set).  |
+| `--meta-graph {auto,skip,reset}`       | `SQL2MG_META_POLICY` | Controls how stored meta graph data is used (default `auto`). |
+| `--log-level LEVEL`                    | `SQL2MG_LOG_LEVEL`   | Sets logging verbosity (`DEBUG`, `INFO`, etc.).               |
+
+## Configuration
+
+Set up your environment variables in `.env`:
+
+```bash
+# Select source database (mysql or postgresql)
+SOURCE_DB_TYPE=postgresql
+
+# PostgreSQL Database (used when SOURCE_DB_TYPE=postgresql)
+POSTGRES_HOST=localhost
+POSTGRES_PORT=5432
+POSTGRES_DATABASE=pagila
+POSTGRES_USER=username
+POSTGRES_PASSWORD=password
+POSTGRES_SCHEMA=public
+
+# MySQL Database (used when SOURCE_DB_TYPE=mysql)
+MYSQL_HOST=localhost
+MYSQL_PORT=3306
+MYSQL_DATABASE=sakila
+MYSQL_USER=username
+MYSQL_PASSWORD=password
+
+# Memgraph Database
+MEMGRAPH_URL=bolt://localhost:7687
+MEMGRAPH_USERNAME=
+MEMGRAPH_PASSWORD=
+MEMGRAPH_DATABASE=memgraph
+
+# LLM API Keys (for LLM-powered features - choose one or more)
+OPENAI_API_KEY=your_openai_key         # For GPT models
+# ANTHROPIC_API_KEY=your_anthropic_key # For Claude models
+# GOOGLE_API_KEY=your_google_key       # For Gemini models
+
+# LLM Provider Configuration (optional - auto-detects if not set)
+# LLM_PROVIDER=openai                  # Options: openai, anthropic, gemini
+# LLM_MODEL=gpt-4o-mini                # Specific model name
+
+# Optional migration defaults (override CLI prompts)
+SQL2MG_MODE=automatic
+SQL2MG_STRATEGY=deterministic
+SQL2MG_META_POLICY=auto
+SQL2MG_LOG_LEVEL=INFO
+```
+
+When switching `SOURCE_DB_TYPE` remember to update the matching credential block and rerun `uv sync` so dependencies like `psycopg2-binary` are installed for PostgreSQL support.
+
+Make sure that Memgraph is started with the `--schema-info-enabled=true`, since agent uses the schema information from Memgraph `SHOW SCHEMA INFO`.
+
+## Multi-LLM Provider Support
+
+The agent supports multiple LLM providers for AI-powered graph modeling:
+
+### Supported Providers
+
+- **OpenAI** (GPT models) - Default: `gpt-4o-mini`
+- **Anthropic** (Claude models) - Default: `claude-3-5-sonnet-20241022`
+- **Google** (Gemini models) - Default: `gemini-1.5-pro`
+
+### Usage Examples
+
+```bash
+# Auto-detect provider based on API keys
+uv run main --strategy llm
+
+# Use specific provider
+uv run main --strategy llm --provider anthropic
+
+# Use specific model
+uv run main --strategy llm --provider openai --model gpt-4o
+
+# All options together
+uv run main --mode incremental --strategy llm --provider gemini --model gemini-1.5-flash
+```
+
+All providers support **structured outputs** for consistent graph model generation. The system automatically validates schemas using Pydantic models.
+
+📖 **[Full Multi-Provider Documentation](docs/MULTI_PROVIDER_SUPPORT.md)**
+
+# Arhitecture
+
+```
+core/hygm/
+├── hygm.py # Main orchestrator class
+├── models/ # Data models and structures
+│ ├── graph_models.py # Core graph representation
+│ ├── llm_models.py # LLM-specific models
+│ ├── operations.py # Interactive operations
+│ └── sources.py # Source tracking
+└── strategies/ # Modeling strategies
+├── base.py # Abstract interface
+├── deterministic.py # Rule-based modeling
+└── llm.py # AI-powered modeling
+```

structured2graph-0.1.1/PROMPT.md

@@ -0,0 +1,90 @@
+# SQL → Graph Migration Agent Prompt
+
+## TL;DR
+
+You are working inside the `agents/sql2graph` package, a UV-managed Python project that turns relational schemas (MySQL/PostgreSQL) into graph schemas and data. The primary entry point is `main.py`, which wires configuration, environment validation, database analyzers, and the HyGM graph-modeling subsystem. Changes usually touch:
+
+- `core/` — Orchestrates the migration workflow (`migration_agent.py`) and HyGM graph modeling (`hygm/`).
+- `database/` — Connectors and analyzers for the source RDBMSs.
+- `query_generation/` — Cypher generation helpers.
+- `utils/` — Environment setup, connection probes, and CLI helpers.
+
+Always maintain the CLI experience (`main.py`) and respect the line-length < 79 char lint rule.
+
+## Tech Stack & Tooling
+
+- Python 3.10+, managed with [uv](https://github.com/astral-sh/uv).
+- Memgraph as the target graph database (Bolt connection).
+- Optional LLM features powered by OpenAI (LangChain / LangGraph patterns inside `core/hygm`).
+- Testing: `pytest` under `tests/` (integration heavy, uses mocks for DB analyzers).
+
+## Core Concepts
+
+- **HyGM (Hypothetical Graph Modeling)** lives in `core/hygm/hygm.py` and exposes modeling modes via `ModelingMode`:
+  - `AUTOMATIC` – one-shot graph generation.
+  - `INCREMENTAL` – table-by-table confirmation flow with an optional refinement
+    loop after processing all tables.
+- **GraphModelingStrategy**: `DETERMINISTIC` (rule-based) and `LLM_POWERED` (needs an LLM+API key).
+- **SQLToMemgraphAgent** (`core/migration_agent.py`) coordinates schema analysis, HyGM modeling, query generation, execution, and validation (note: class name retained for compatibility).
+- **Database analyzers** in `database/` introspect MySQL/PostgreSQL schemas and emit a normalized metadata structure consumed by HyGM.
+- **Query generation** in `query_generation/` converts the graph model + metadata into Cypher migrations, indexes, and constraints.
+- **Database data interfaces** in `database/models.py` define the canonical `TableInfo`, `ColumnInfo`, `RelationshipInfo`, and `DatabaseStructure` data classes. These objects flow from analyzers into HyGM via the `to_hygm_format()` helpers, ensuring consistent schema metadata for every modeling mode.
+- **Graph schema structures** in `core/hygm/models/graph_models.py` (e.g., `GraphModel`, `GraphNode`, `GraphRelationship`) capture the in-memory graph representation HyGM produces and later serializes to schema format.
+- **LLM structured output models** in `core/hygm/models/llm_models.py` (`LLMGraphModel`, `LLMGraphNode`, `LLMGraphRelationship`) describe the contract for AI-generated schemas and include `to_graph_model()` utilities to convert LLM responses into the standard `GraphModel` objects.
+- The `GraphModel` serialization format matches the canonical spec in `core/schema/spec.json`, so any changes to the schema data classes should be mirrored against that document.
+- Source tracking helpers in `core/hygm/models/sources.py` annotate nodes, relationships, properties, indexes, and constraints with origin metadata. Preserve these when modifying `GraphModel` so downstream migrations retain the link back to the originating tables or user-applied changes.
+
+## Entry Points & CLI Flow
+
+- Run with `uv run main.py` (banner, env checks, connection probes, then the migration workflow).
+- CLI prompts include:
+  - Graph modeling mode (automatic / incremental with interactive refinement).
+  - Modeling strategy (deterministic / AI-powered).
+  - Confirmation dialogs during automatic or incremental flows.
+  - Post-session prompts that let users launch the interactive refinement loop
+    after reviewing every table in an incremental run.
+- Environment validation happens before migration; failures raise `MigrationEnvironmentError` or `DatabaseConnectionError` from `utils/`.
+
+## Configuration & Environment
+
+- `.env` (or env vars) must provide:
+  - `SOURCE_DB_*` (host, port, name, user, password, type [`mysql|postgresql`]).
+  - `MEMGRAPH_*` connection details.
+  - `OPENAI_API_KEY` for LLM features; omit or leave empty to disable LLM strategy.
+- Memgraph must run with `--schema-info-enabled=true` for schema validation.
+
+## Testing & Validation
+
+- Install deps: `uv sync` (or `uv pip install -e .`).
+- Run targeted tests: `uv run python -m pytest tests/test_integration.py -v`.
+- Keep graph-modeling logic covered via integration tests; they rely on mocked analyzers.
+- Observe linting: adhere to 79-character lines and existing logging conventions (`logging` module).
+
+## Development Tips
+
+- Update `PROMPT.md` when project layout or workflows change.
+- Prefer existing abstractions: use `SQLToMemgraphAgent` methods, HyGM strategies/helpers, and database adapters.
+- For new modeling flows, ensure `ModelingMode` and CLI choices stay in sync.
+- Preserve user-facing prompts/emojis—they guide the interactive experience.
+- When adding LLM-dependent features, guard them when API keys or clients are missing.
+- Document new commands or config expectations in this prompt and `README.md` if user-facing.
+
+## Useful Commands
+
+```bash
+# Sync dependencies
+uv sync
+
+# Run the CLI
+uv run main.py
+
+# Run tests
+uv run python -m pytest tests -v
+```
+
+## When Generating Code
+
+- Mention which files you change and why, referencing modules above.
+- Explain how to rerun the CLI or relevant tests after modifications.
+- Provide small follow-up suggestions if more validation is needed.
+- Keep output concise but cover context so the next agent run has everything it needs.

structured2graph-0.1.1/README.md

@@ -0,0 +1,155 @@
+# SQL Database to Graph Migration Agent
+
+Intelligent database migration agent that transforms SQL databases (MySQL, PostgreSQL) into graph databases, powered by LLM analysis and LangGraph workflows.
+
+## Overview
+
+This package provides a sophisticated migration agent that:
+
+- **Analyzes SQL database schemas** - Automatically discovers tables, relationships, and constraints
+- **Generates optimal graph models** - Uses AI to create node and relationship structures
+- **Creates indexes and constraints** - Ensures performance and data integrity
+- **Handles complex relationships** - Converts foreign keys to graph relationships
+- **Incremental refinement** - Review each table, adjust the model
+  immediately, then enter the interactive refinement loop once all tables
+  are processed
+- **Comprehensive validation** - Verifies migration results and data integrity
+
+## Installation
+
+```bash
+# Install the package
+uv pip install .
+
+# Or install in development mode
+uv pip install -e .
+```
+
+## Quick Start
+
+Run the migration agent:
+
+```bash
+uv run main
+```
+
+The agent will guide you through:
+
+1. Environment setup and database connections
+2. Graph modeling strategy selection
+3. Automatic or incremental migration mode
+4. Complete migration workflow with progress tracking
+
+> **Incremental review:** The LLM now drafts the entire graph model in a single
+> shot and then walks you through table-level changes detected since the last
+> migration. You only need to approve (or tweak) the differences that matter.
+
+You can also preconfigure the workflow using CLI flags or environment variables:
+
+```bash
+uv run main --mode incremental --strategy llm --meta-graph reset --log-level DEBUG
+```
+
+| Option                                 | Environment          | Description                                                   |
+| -------------------------------------- | -------------------- | ------------------------------------------------------------- |
+| `--mode {automatic,incremental}`       | `SQL2MG_MODE`        | Selects automatic or incremental modeling flow.               |
+| `--strategy {deterministic,llm}`       | `SQL2MG_STRATEGY`    | Chooses deterministic or LLM-powered HyGM strategy.           |
+| `--provider {openai,anthropic,gemini}` | `LLM_PROVIDER`       | Selects LLM provider (auto-detects if not specified).         |
+| `--model MODEL_NAME`                   | `LLM_MODEL`          | Specifies LLM model name (uses provider default if not set).  |
+| `--meta-graph {auto,skip,reset}`       | `SQL2MG_META_POLICY` | Controls how stored meta graph data is used (default `auto`). |
+| `--log-level LEVEL`                    | `SQL2MG_LOG_LEVEL`   | Sets logging verbosity (`DEBUG`, `INFO`, etc.).               |
+
+## Configuration
+
+Set up your environment variables in `.env`:
+
+```bash
+# Select source database (mysql or postgresql)
+SOURCE_DB_TYPE=postgresql
+
+# PostgreSQL Database (used when SOURCE_DB_TYPE=postgresql)
+POSTGRES_HOST=localhost
+POSTGRES_PORT=5432
+POSTGRES_DATABASE=pagila
+POSTGRES_USER=username
+POSTGRES_PASSWORD=password
+POSTGRES_SCHEMA=public
+
+# MySQL Database (used when SOURCE_DB_TYPE=mysql)
+MYSQL_HOST=localhost
+MYSQL_PORT=3306
+MYSQL_DATABASE=sakila
+MYSQL_USER=username
+MYSQL_PASSWORD=password
+
+# Memgraph Database
+MEMGRAPH_URL=bolt://localhost:7687
+MEMGRAPH_USERNAME=
+MEMGRAPH_PASSWORD=
+MEMGRAPH_DATABASE=memgraph
+
+# LLM API Keys (for LLM-powered features - choose one or more)
+OPENAI_API_KEY=your_openai_key         # For GPT models
+# ANTHROPIC_API_KEY=your_anthropic_key # For Claude models
+# GOOGLE_API_KEY=your_google_key       # For Gemini models
+
+# LLM Provider Configuration (optional - auto-detects if not set)
+# LLM_PROVIDER=openai                  # Options: openai, anthropic, gemini
+# LLM_MODEL=gpt-4o-mini                # Specific model name
+
+# Optional migration defaults (override CLI prompts)
+SQL2MG_MODE=automatic
+SQL2MG_STRATEGY=deterministic
+SQL2MG_META_POLICY=auto
+SQL2MG_LOG_LEVEL=INFO
+```
+
+When switching `SOURCE_DB_TYPE` remember to update the matching credential block and rerun `uv sync` so dependencies like `psycopg2-binary` are installed for PostgreSQL support.
+
+Make sure that Memgraph is started with the `--schema-info-enabled=true`, since agent uses the schema information from Memgraph `SHOW SCHEMA INFO`.
+
+## Multi-LLM Provider Support
+
+The agent supports multiple LLM providers for AI-powered graph modeling:
+
+### Supported Providers
+
+- **OpenAI** (GPT models) - Default: `gpt-4o-mini`
+- **Anthropic** (Claude models) - Default: `claude-3-5-sonnet-20241022`
+- **Google** (Gemini models) - Default: `gemini-1.5-pro`
+
+### Usage Examples
+
+```bash
+# Auto-detect provider based on API keys
+uv run main --strategy llm
+
+# Use specific provider
+uv run main --strategy llm --provider anthropic
+
+# Use specific model
+uv run main --strategy llm --provider openai --model gpt-4o
+
+# All options together
+uv run main --mode incremental --strategy llm --provider gemini --model gemini-1.5-flash
+```
+
+All providers support **structured outputs** for consistent graph model generation. The system automatically validates schemas using Pydantic models.
+
+📖 **[Full Multi-Provider Documentation](docs/MULTI_PROVIDER_SUPPORT.md)**
+
+# Arhitecture
+
+```
+core/hygm/
+├── hygm.py # Main orchestrator class
+├── models/ # Data models and structures
+│ ├── graph_models.py # Core graph representation
+│ ├── llm_models.py # LLM-specific models
+│ ├── operations.py # Interactive operations
+│ └── sources.py # Source tracking
+└── strategies/ # Modeling strategies
+├── base.py # Abstract interface
+├── deterministic.py # Rule-based modeling
+└── llm.py # AI-powered modeling
+```