Skip to content

ghksdl6025/Traceory

Repository files navigation

Traceory logo

🧭 Traceory

A friendly process analyst for your event logs.
Import a log, explore the process, and ask questions in plain language.

Windows Release License

🪟 Download for Windows   |   All releases

✨ What can it do?

Traceory is a local desktop app for people who want process-mining insight without learning a query language first.

Explore Understand
🗺️ Process maps See activities, paths, frequency, and waiting time
🔎 Cases and variants Compare common routes and inspect unusual cases
💬 AI process analyst Ask about delays, rework, risk, and improvements
📚 Process documents Add PDF, Markdown, or text policies for grounded answers

Traceory analysis workspace

🚀 Getting started

  1. Download and install the latest Windows release.
  2. Import a .csv or .xlsx event log.
  3. Confirm the case ID, activity, and timestamp columns.
  4. Explore the map, statistics, variants, and cases.
  5. Optionally add your own OpenAI API key and ask the analyst a question.

Use the EN / DE selector in the app header to switch between English and German. Agent answers follow the selected language.

Traceory checks GitHub Releases at startup and can download, verify, and install new versions from inside the desktop app.

💡 No API key? The process map, statistics, variants, and case explorer still work. AI features are optional.

🔒 Local by default

Your event logs, settings, and generated files stay on your computer. Traceory does not ship with an API key and does not perform real ERP, email, database, or RPA actions.

The preview is currently available for Windows x64. An unsigned preview may show a Windows SmartScreen warning. Release downloads include a matching SHA-256 checksum.

Build from source

Requirements

  • Python 3.14
  • Node.js 22

Backend

git clone https://github.com/ghksdl6025/Traceory.git
cd Traceory
python -m pip install -r requirements-dev.txt
python -m pytest

Frontend

cd src/frontend
npm install
npm run build

Windows desktop bundle

powershell -ExecutionPolicy Bypass -File src/scripts/build_windows_app.ps1

All application source lives under src/. Tests and sample logs stay at the repository root.

📄 License

Traceory is available under the MIT License. See Privacy and Security for details.

Releases

Packages

Contributors

Languages