OmniCraft ERP

English

Русский

English

Русский

Appearance

⚙️ Global Settings: Language, Currency, and Security ​

Unlike Workspace Settings, which affect the economics of a specific business (rates, markups, overhead costs), Global Settings establish the fundamental rules of operation for the entire application and your local database.

To open them, click File ➔ Program Settings in the top menu.

🌍 Localization and Currency ​

1. Interface Language ​

The program supports full interface localization. Upon its very first launch, OmniCraft ERP automatically scans your operating system's language and adapts to it. You can switch between Russian (RU) and English (EN) at any time.

  • How it works: Changing the language requires a full restart of the application so that all system windows, cash flow categories, and directories are properly translated and loaded from the dictionary databases.

2. Accounting Currency ​

By default, the program pulls your national currency symbol from your OS regional settings (e.g., ₽, $, €, £, ₺). You can change it to any other currency using the convenient built-in search tool (just start typing the name, such as “Euro” or “Lira”).

Protecting Historical Data

The currency change button is automatically locked as soon as you begin recording real transactions (the moment you register your first purchase, sale, or cash flow entry).

This is done to protect your financial reporting. If the program allowed you to switch currencies on the fly, all your previous receipts, balances, and analytical charts would instantly become a mathematical mess. What if you relocate to another country? You will need to perform an "Accounting Reset" (see below) to start keeping books in the new currency from a clean slate, while preserving your existing directories and recipes.

🤖 AI Features (Core AI Hub & BYOK) ​

OmniCraft ERP includes intelligent assistant features powered by artificial intelligence under the BYOK model (Bring Your Own Key).

All requests to neural network providers are transmitted directly from your device to the provider's API. Your business records, proprietary recipes, client lists, and financial reports never pass through intermediate OmniCraft ERP proxy servers, ensuring 100% data privacy and security.

1. Supported AI Providers ​

  • OpenAI (GPT-4o, GPT-4o-mini, o1, o3-mini);
  • DeepSeek (DeepSeek-Chat, DeepSeek-Reasoner / R1);
  • Google Gemini (Gemini 1.5 Flash, Gemini 1.5 Pro, Gemini 2.0);
  • Anthropic (Claude 3.5 Sonnet, Claude 3.5 Haiku, Claude 3 Opus);
  • OpenRouter (access to dozens of top models via a single API key);
  • Custom Endpoint / Local Ollama (fully private and offline execution).

AI settings are organized into a dedicated "AI Agent" tab in Program Settings with one-click deep linking from assistant shortcuts:

  • Isolated Per-Provider Configurations: Each neural network provider securely retains its own credentials, chosen model, and custom endpoint URL. Switching providers instantly restores their respective saved parameters, preventing credential collisions.
  • Reactive Base URL & Local Models: When working with local models (Ollama, LM Studio, or custom gateways), entering a custom Base URL automatically locks cloud dropdowns and activates a dedicated Model ID field directly below, accompanied by a helpful guidance tooltip (?).
  • Pure Model Filtering Without Ghost Items: The model selection dialog performs strict filtering over the provider's verified catalog without injecting search query text as synthetic model entries.
  • Standardized Form Typography: Input fields for API keys, Base URLs, and Model IDs strictly adhere to the standard design system font size (13px), eliminating bloated password masking dots.
  • Live Connection Diagnostics: The application continuously verifies endpoint connectivity in the background, showing a responsive animated progress ring and clear status badges.
  • Self-Healing Vault: Migrating database files between computers triggers a non-disruptive key re-authorization prompt without application crashes.

2. Hardware-Level Key Protection (Windows DPAPI) ​

Your API key is encrypted on disk using native operating system cryptographic protection (Windows Data Protection API — DPAPI). The encrypted secret is bound to your user account and computer hardware, preventing unauthorized extraction by third-party utilities or configuration file leaks.

3. Assistant Buttons ("Spark Buttons" ✨) in Workspaces ​

When AI is configured, smart assistant buttons become available in key modules:

  • Batch Calculator: in-depth cost structure audit, identification of main cost drivers, and batch pricing advice.
  • Materials Warehouse: instant generation of technical item descriptions, specifications, and storage recommendations.
  • Production Workbench: operational checklist for the craftsman with quality checkpoints and raw material risk assessments.

If an API key is not yet configured, clicking any assistant button presents a gentle shortcut dialog to the Settings window without disrupting your current workflow. The application remains 100% functional without AI.

4. Built-in AI Assistant (Right Sidebar Panel) ​

A sliding assistant panel is docked to the right edge of the main application window.

  • Non-intrusive by Default: The panel remains collapsed into a slim 38px bar with a compact icon, never distracting the craftsman or cluttering the workspace.
  • Screen Context Awareness: The assistant detects the active module (Warehouse, Workbench, Calculator, Sales) and grounds its responses in current stock and configuration. You can disable screen context at any time using the header toggle or click the preview icon to inspect the exact data snapshot sent to the model.
  • Scope Selector (Active Tab vs Full App): An interactive badge in the panel header switches between "🔒 Tab" (strict isolation restricting tool calls to the active screen) and "🌐 All System" (smart cross-module routing with access to all registered tools).
  • Human-in-the-Loop Safety (Zero-Destruction): When the assistant proposes an operational action (such as generating links or updating records), it presents a structured action card. Mutating operations are executed only after your explicit confirmation via the "Execute" button.
  • Private Mode: When connected to a local model (such as Ollama), a green "Offline" badge confirms that processing takes place entirely on your device without internet transmission.

5. Global AI Instruction ​

The internal assistant's system prompt is assembled using a modular multi-tier pipeline:

  • Core Accounting Safeguards: Built-in craftsman mentor rules, accounting invariants (Moving Average Cost MAC for raw materials, FIFO write-offs for finished goods, integer scaling for currency), and the Zero-Destruction policy are strictly enforced by the program core.
  • Workshop Specifics (System Context): A customizable profile in Program Settings pre-filled with an overarching craftsman manifesto (total cost of production, material and consumable accounting, labor time estimates, scrap allowances, and equipment depreciation). You can adapt this prompt to your specific craft at any time.
  • Workspace Scope: Contextual guidelines tailored to the active workspace profile (Production, Services, Personal Capital).
  • Tab Context: Targeted instructions for the active module (Warehouse, Workbench, Calculator, Sales, Cash Flow).
  • Task Sparks: Contextual micro-prompts triggered by one-click spark buttons.

Thanks to the Stable Prefix architecture, immutable system layers are cached by the LLM provider, dramatically cutting response latency and reducing token costs.

6. Long-Term Memory, Self-Learning, and Token Budgeting ​

OmniCraft ERP includes a native long-term memory engine powered by lightweight local SQLite FTS5 full-text search with BM25 ranking. The assistant learns craftsman habits, technical nuances, and workshop rules without heavy external libraries.

  • Learning Modes & Autopilot: Program Settings provide an explicit toggle for automated assistant self-learning. Craftsmen can choose between interactive confirmation prompts or seamless autopilot mode without disruption.
  • Token Budget & Memory Compaction: To keep system prompts concise and responsive, rule memory features a configurable token limit (1,000 tokens by default). As memory fills, background compaction automatically prunes stale or low-confidence rules while preserving core workshop guidelines.
  • Reflexion Learning Loop: When declining an action proposed by the assistant (clicking "Cancel" on an Action Card), a concise feedback dialog opens. If you specify the reason (e.g., “We only package oil in 0.5 L bottles, never 1 L”), the assistant formulates a rule and commits it to memory for that section, preventing repeated mistakes.
  • Pinning Rules to Memory (Pin Icon 📌): Every assistant message features a compact pin button in its upper-right corner. You can pin key answers or manufacturing rules to long-term memory with a single click.
  • Memory Inspector in Settings: The "AI Agent" tab in Program Settings provides a complete view of all learned rules. You can toggle rules on and off, delete obsolete items, or manually add new rules with global or tab-specific scope.
  • Workspace Sandboxing: Rules originating from the Personal Capital module are strictly partitioned and never bleed into commercial workshop spaces.

7. External AI Agents (MCP Stdio Server) ​

OmniCraft ERP supports the standardized Model Context Protocol (MCP, 2024-11-05 specification) for interaction with external autonomous agents. This enables external developer tools and agent clients (Cursor, Claude Desktop, Antigravity) to communicate directly with the application via local inter-process communication (stdio).

  • Unified Entry Point: All registered application modules expose their tools through a single central registry. An external agent connects with a single configuration snippet and accesses capabilities across the entire system.
  • Pairing Token and One-Click Revocation: For secure pairing, the settings window generates a unique cryptographic pairing token. If you need to terminate agent access, simply click "Revoke Token"—external connections are immediately invalidated.
  • Ready-to-Copy Configuration: Clicking "Copy JSON Config" generates a standard JSON configuration snippet ready for insertion into your agent configuration (claude_desktop_config.json or Cursor mcp.json).
  • Trusted Mode (Protection Against Unauthorized Changes): By default, external agents are restricted to safe read-only operations. Any mutating operations (such as link generation or record updates) are blocked at the core registry level. To allow modifications, you must explicitly enable "Trusted Mode" in the Program Settings.
  • End-to-End Audit Trail: Every agent invocation is recorded in the system audit log with caller identity, tool name, input arguments, status, and execution latency in milliseconds.

8. Hierarchical Skills & System Registries (Help ➔ System Registries) ​

The program provides a unified control center for automation workflows and system instruction inspection — the "AI Skills & Prompts Registry", accessible via the top menu Help ➔ System Registries.

  • Hierarchical Tree Navigation: The registry interface is organized into a three-tier tree (Program ➔ Workspaces ➔ Tab Domains). Selecting any node (such as Warehouse, Workshop, or Calculator) allows the craftsman to inspect the active system instruction for that level alongside its assigned scenarios.
  • Skills Library (Reusable Scenarios): Each skill represents a pre-configured workflow template bound to a specific scope (global, space, or tab). You can toggle built-in skills on and off with switches or create custom scenarios using the "+ New Skill" button.
  • Interactive Suggested Chips: Tab-level skills automatically populate as interactive chips at the top of the expanded assistant panel. As you switch modules, these chips instantly adapt to the active screen, enabling one-click raw material deficit audits or cost breakdown queries.
  • Exporting AI Map to Markdown: The "Export AI Map to Markdown" button in the registry header generates a comprehensive, structured report covering all prompt tiers (L0–L3), the skills library, registered tools, and learned memory rules, copying it directly to the clipboard.

9. PC Agent Mode & Four-Level Security Gate (HITL) ​

To enable safe interaction between the AI assistant, the local filesystem, and operating system utilities, OmniCraft ERP incorporates a four-tier authorization gateway:

  • PC Agent Mode Toggle: By default, this mode is strictly disabled. While disabled in the assistant settings, the application unconditionally blocks any attempt to access external files or invoke OS commands.
  • Allowed Directories Whitelist: You can specify trusted folder paths (e.g., C:\Reports; C:\Exports), restricting file operations exclusively to these locations. Direct access to system database files (*.db, *.sqlite) and environment secrets (.env) is categorically forbidden.
  • Four-Level Authorization Matrix (Human-in-the-Loop):
    • 🟢 Class 1 (ERP Read): Querying stock balances, calculating batch costs, and viewing analytics — executed automatically without disruptive prompts.
    • 🟡 Class 2 (ERP Mutation): Deducting materials, registering sales, or booking cash flow entries — presented via an Action Card with "Execute" and "Reject" buttons.
    • 🟠 Class 3 (Filesystem & Hardware): Saving export reports, inspecting invoices, printing labels — requires explicit modal confirmation of the target path or printer device.
    • 🔴 Class 4 (OS Execution / Critical Red): Executing system commands and external binaries — displayed within a blocking red security modal featuring full command inspection, Zero-Destruction Policy enforcement, and a mandatory 3-second delay timer on the confirmation button to prevent accidental clicks.

☢️ Danger Zone ​

At the bottom of the settings window, you will find tools for radical database interventions. These buttons should be used with extreme caution.

🧹 Accounting Reset (Wiping Transaction History) ​

This tool is designed to "zero out" the operational memory of the business without losing its infrastructure. It is ideal if you have been using the program in a trial/test mode, recorded many test receipts, and now want to start keeping real books from a clean slate.

What will be DELETED (Logs)What will be ZEROED (Balances)What will be SAVED (Infrastructure)
• Entire sales history (receipts)• Physical materials stock in warehouse• All equipment & assets (Workshop)
• Inventory movement logs• Finished goods stock (Showcase)• Materials directories & supplier links
• Cash flow ledger (Cash Flow)• Cash register balances & Cash Flow history• All product templates & Recipes
• Production queue (Workbench)• FIFO batch cost values• Categories, pack types, global settings

Prior to performing the wipe, the program will automatically create a shadow backup of the database. After clicking "Clear History" (Accounting Reset), OmniCraft ERP will prompt an automatic reboot. You will receive a clean workshop, ready for the initial stock inventory (see Quick Start).

💥 Factory Reset ​

This is the "red pill" button—the ultimate database reset. It permanently deletes absolutely everything from your local SQLite database.

  • All tables, directories, recipes, receipts, stock balances, settings, and license keys vanish completely.
  • Upon the next startup, the program will generate a brand new database, exactly as if you had just downloaded and installed OmniCraft ERP for the very first time.

Attention!

Before using this function, always make a manual data export (File ➔ Export Data ➔ Backup Database .db) if there is even a slight chance you might need this information in the future. Recovering data after a factory reset without a backup file is impossible.

🔄 Automatic Reboot ​

Any changes in the Global Settings (changing the language, currency, or resetting accounts) require a reconfiguration of the operational memory. After saving changes, the program will prompt you to reboot now or do it later.

During the reboot, OmniCraft ERP carefully preserves your window geometry (size and position on the screen), allowing you to resume your work exactly where you left off.