https://github.com/epam/dm.ai
EPAM AI/Run DMTools
https://github.com/epam/dm.ai
Last synced: about 2 months ago
JSON representation
EPAM AI/Run DMTools
- Host: GitHub
- URL: https://github.com/epam/dm.ai
- Owner: epam
- License: other
- Created: 2026-03-19T13:22:16.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-05-01T21:37:48.000Z (3 months ago)
- Last Synced: 2026-05-01T21:38:18.704Z (3 months ago)
- Language: Java
- Size: 5.63 MB
- Stars: 9
- Watchers: 1
- Forks: 3
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# DMTools
Enterprise dark-factory orchestrator for automating delivery workflows across trackers, source control, documentation, design systems, AI providers, and CI/CD.
> Quick install
>
> ```bash
> curl -fsSL https://github.com/epam/dm.ai/releases/latest/download/install.sh | bash
> ```
>
> PowerShell: https://github.com/epam/dm.ai/releases/latest/download/install.ps1
[](https://github.com/epam/dm.ai/releases/latest) [](https://codecov.io/gh/epam/dm.ai) [](https://jitpack.io/#epam/dm.ai)
> DMTools is orchestration layer for enterprise dark factories. It is designed for self-hosted and enterprise environments where teams need repeatable AI-assisted workflows instead of one-off scripts or server-first demos.
## What DMTools is for
DMTools helps platform, delivery, QA, and engineering teams orchestrate end-to-end work such as:
- running MCP tools against Jira, Azure DevOps, GitHub, Confluence, Figma, Teams, SharePoint, and AI providers
- executing reusable jobs and agents for analysis, test generation, reporting, and teammate workflows
- wiring GitHub Actions and other CI/CD pipelines into delivery automation
- packaging focused AI assistant skills for project-level usage in Cursor, Claude, and Codex
## Primary usage paths
| Usage path | What you do with it | Start here |
|---|---|---|
| CLI + MCP tools | Execute direct tool calls and integration operations from the terminal | [MCP tools reference](dmtools-ai-docs/references/mcp-tools/README.md) |
| Jobs + agents | Run orchestrated workflows such as Teammate, reporting, and test generation | [Jobs reference](dmtools-ai-docs/references/jobs/README.md) |
| GitHub workflow automation | Run DMTools in CI/CD for ticket processing and teammate flows | [GitHub Actions teammate workflow](dmtools-ai-docs/references/workflows/github-actions-teammate.md) |
| AI assistant skills | Install project-level DMTools skills for agent-driven usage | [Skill guide](dmtools-ai-docs/SKILL.md) |
## Documentation map
All maintained documentation lives under [dmtools-ai-docs/](dmtools-ai-docs/).
| Topic | Link |
|---|---|
| Installation and upgrade | [references/installation/README.md](dmtools-ai-docs/references/installation/README.md) |
| Configuration overview | [references/configuration/README.md](dmtools-ai-docs/references/configuration/README.md) |
| Integration setup guides | [references/configuration/integrations/](dmtools-ai-docs/references/configuration/integrations/) |
| MCP tools reference | [references/mcp-tools/README.md](dmtools-ai-docs/references/mcp-tools/README.md) |
| Jobs and workflow orchestration | [references/jobs/README.md](dmtools-ai-docs/references/jobs/README.md) |
| GitHub workflow guidance | [references/workflows/github-actions-teammate.md](dmtools-ai-docs/references/workflows/github-actions-teammate.md) |
| GitHub repository discoverability | [references/workflows/github-repository-discoverability-playbook.md](dmtools-ai-docs/references/workflows/github-repository-discoverability-playbook.md) |
| Examples | [references/examples/](dmtools-ai-docs/references/examples/) |
| Documentation index | [dmtools-ai-docs/README.md](dmtools-ai-docs/README.md) |
## Quick start
### Installation
**Latest Version:** [](https://github.com/epam/dm.ai/releases/latest) — browse the [latest releases page](https://github.com/epam/dm.ai/releases/latest) for installer assets.
**macOS / Linux / Git Bash:**
```bash
curl -fsSL https://github.com/epam/dm.ai/releases/latest/download/install.sh | bash
```
**Windows PowerShell:**
```powershell
irm https://github.com/epam/dm.ai/releases/latest/download/install.ps1 | iex
```
**Java baseline:** Java 17+ for the DMTools CLI and Agent Skill installer flow.
### Agent Skill
Run the Agent Skill installer from your project root so it can detect project-level skill directories:
```bash
curl -fsSL https://github.com/epam/dm.ai/releases/latest/download/skill-install.sh | bash
curl -fsSL https://github.com/epam/dm.ai/releases/latest/download/skill-install.sh | bash -s -- --skills jira,github
```
For shared base configs and child-agent overrides, use the existing [`parent` config inheritance pattern](dmtools-ai-docs/references/configuration/json-config-rules.md#config-inheritance-via-parent).
**Verify installation:**
```bash
dmtools --version
dmtools list
```
### Minimal configuration
```bash
cat > dmtools.env << EOF
JIRA_BASE_PATH=https://your-company.atlassian.net
JIRA_EMAIL=your-email@company.com
JIRA_API_TOKEN=your-jira-api-token
GEMINI_API_KEY=your-gemini-api-key
EOF
chmod 600 dmtools.env
```
For provider-specific and integration-specific setup, use the maintained docs instead of copying old snippets from the repository root:
- [Configuration overview](dmtools-ai-docs/references/configuration/README.md)
- [Integration setup guides](dmtools-ai-docs/references/configuration/integrations/)
### First commands
```bash
dmtools list
dmtools jira_get_ticket YOUR-123
dmtools run agents/story_development.json
```
## Upgrading from legacy installs
Keep the latest-release installer flow introduced in DMC-858 when refreshing existing environments.
1. Back up `~/.dmtools` before changing anything so you can restore the current wrapper, JAR, and local state if migration fails.
2. Re-run the installer from `https://github.com/epam/dm.ai/releases/latest/download/install.sh` (or `install.bat` / `install.ps1` on Windows) to replace any legacy bootstrap URLs.
3. Preserve or merge your existing `dmtools.env`, `dmtools-local.env`, and local configuration instead of overwriting them.
4. Remove stale aliases, wrapper scripts, and PATH entries that resolve outside `~/.dmtools/bin`.
5. Verify the migrated install with `dmtools --version` and `dmtools list`.
6. If anything fails, roll back by restoring the backup copy of `~/.dmtools` and reactivating the previous wrapper or PATH configuration.
Tagged reinstall example for rollback or migration validation:
**macOS / Linux / Git Bash:**
```bash
curl -fsSL https://github.com/epam/dm.ai/releases/download/v1.7.179/install.sh | bash -s -- v1.7.179
```
**Windows:**
```cmd
set DMTOOLS_VERSION=v1.7.179 && curl -fsSL https://github.com/epam/dm.ai/releases/download/v1.7.179/install.bat -o "%TEMP%\dmtools-install.bat" && "%TEMP%\dmtools-install.bat"
```
## Build from source
```bash
./gradlew :dmtools-core:shadowJar
./buildInstallLocal.sh
```
See the [installation guide](dmtools-ai-docs/references/installation/README.md) for local development installation details.