Skip to content

hyperpolymath/rpa-elysium

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

130 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

RPA Elysium

Jonathan D.A. Jewell <[email protected]>

RPA Paradise — A next-generation robotic process automation toolkit

RSR Certified Status

Project Status

Important

Current Phase: Phase 2 — Automation Modules (Next)

Phase 1 (Core Framework) completed 2026-03-17. This repository contains:

  • Rust workspace with 8 crates (rpa-core, rpa-config, rpa-events, rpa-plugin, rpa-resources, rpa-scheduler, rpa-state, rpa-fs-workflow)

  • Bot framework with scheduling, state management, event bus, and resource pooling

  • Working filesystem automation CLI (rpa-fs-workflow)

  • CI/CD infrastructure and governance workflows (17 workflows)

  • Language policy and development standards

  • Multi-forge distribution setup

See Roadmap for development phases.

Overview

RPA Elysium is a comprehensive robotic process automation toolkit designed to streamline business workflows, automate repetitive tasks, and maximise operational efficiency. Built on the Hyperpolymath language standards, it prioritises type safety, performance, and freedom from Big Tech dependencies.

Vision

Core Capabilities

Capability Description

Cross-Platform Automation

Automate tasks across web, desktop, and mobile applications

Visual Workflow Designer

Intuitive interface for building automation workflows

AI-Powered Recognition

Smart element detection and adaptive UI interaction

Scheduled Execution

Automated tasks on custom schedules

Error Handling & Recovery

Robust error management with automatic retry mechanisms

Integration Ready

Connect with business tools and APIs

Scalable Architecture

From single bot to enterprise-wide deployment

Detailed Analytics

Monitor performance, track success rates, optimise workflows

Planned Architecture

┌─────────────────────────────────────────────────────────────────┐
│                     Management Console (ReScript)               │
│         Workflow Designer │ Monitoring │ Analytics              │
├─────────────────────────────────────────────────────────────────┤
│                        Bot Framework (Rust)                     │
│      Task Scheduling │ State Management │ Resource Allocation   │
├─────────────────────────────────────────────────────────────────┤
│                     Automation Modules (Rust/ReScript)          │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────────┐   │
│  │   Web    │ │ Desktop  │ │   API    │ │ Document/Email   │   │
│  │Automation│ │Automation│ │Integration│ │   Processing    │   │
│  └──────────┘ └──────────┘ └──────────┘ └──────────────────┘   │
├─────────────────────────────────────────────────────────────────┤
│                   AI & Intelligence (Rust + WASM)               │
│            OCR │ Form Recognition │ NLP │ Pattern Learning      │
├─────────────────────────────────────────────────────────────────┤
│                    Backend Services (Gleam on BEAM)             │
│              Job Queue │ Event Bus │ Persistence                │
└─────────────────────────────────────────────────────────────────┘

Technology Stack

Layer Technology Rationale

Application Logic

ReScript

Type-safe, compiles to efficient JS

Performance-Critical

Rust

Systems programming, WASM compilation

Runtime

Deno

Secure, modern JS/TS runtime

Backend Services

Gleam

Functional, runs on BEAM for reliability

Mobile

Tauri 2.0+ / Dioxus

Rust-first mobile, no Kotlin/Swift

Configuration

Nickel

Programmable, typed configuration

Package Management

Guix (primary), Nix (fallback)

Reproducible builds

What We Don’t Use

  • No TypeScript (ReScript instead)

  • No Node.js/npm/Bun (Deno instead)

  • No Go (Rust instead)

  • No Python except SaltStack (ReScript/Rust instead)

  • No Kotlin/Swift for mobile (Tauri/Dioxus instead)

Use Cases

  • Data Entry Automation — Eliminate manual data input across systems

  • Report Generation — Automatically compile and distribute reports

  • Customer Service — Automated ticket routing and responses

  • Invoice Processing — Extract, validate, and process invoices

  • System Integration — Bridge legacy and modern systems

  • Compliance & Auditing — Automated compliance checks and logging

Roadmap

See ROADMAP.adoc for detailed development phases.

Phase Summary

Phase Focus Status

0. Foundation

Project infrastructure, CI/CD, governance

✓ Complete

1. Core Framework

Bot framework, task scheduling, state management

✓ Complete

2. Automation Modules

Web, desktop, API, document automation

Planned

3. AI & Intelligence

OCR, form recognition, NLP integration

Planned

4. Management Console

Workflow designer, monitoring, analytics

Planned

5. Mobile & Marketplace

Mobile management app, workflow sharing

Future

Repository Structure

rpa-elysium/
├── .claude/              # AI assistant configuration
│   └── CLAUDE.md         # Language policy (Hyperpolymath Standard)
├── .github/
│   └── workflows/        # CI/CD pipelines (17 workflows)
├── .machine_readable/    # Structured project metadata (A2ML)
├── crates/               # Rust workspace crates
│   ├── rpa-core/         # Core types, traits, abstractions
│   ├── rpa-plugin/       # WASM plugin system
│   └── rpa-fs-workflow/  # Filesystem automation CLI (MVP)
├── src/abi/              # Idris2 ABI definitions
├── ffi/zig/              # Zig FFI implementation
├── services/             # Backend services (Gleam)
├── docs/                 # Documentation
├── examples/             # Example workflow configs
├── LICENSE               # PMPL-1.0-or-later
├── README.adoc           # This file
├── ROADMAP.adoc          # Development roadmap
└── justfile              # Build automation

Multi-Forge Distribution

This project is mirrored across multiple forges:

Security

  • Encrypted credential storage

  • Role-based access control

  • Audit logging

  • SOC2 and GDPR compliance considerations

  • SHA-256+ for all cryptographic operations

  • HTTPS only — no HTTP URLs

Contributing

Contributions welcome once implementation begins. See CONTRIBUTING.md for guidelines.

All contributions must adhere to the Hyperpolymath Language Policy.

License

Palimpsest License (PMPL-1.0-or-later) 2025-2026 Jonathan D.A. Jewell

Author

Jonathan D.A. Jewell

Acknowledgements

  • Open source RPA community

  • Rust, ReScript, Gleam, and Deno communities

  • Automation pioneers and thought leaders


Transform your business processes — Watch this repository to stay updated with development progress.

Integration with Hybrid Automation Router

RPA Elysium works standalone as a filesystem automation CLI, or as a target for the Hybrid Automation Router (HAR).

Mode Description

Standalone

Run rpa-fs run workflow.json directly. Events come from filesystem watchers only.

With HAR

HAR routes events from multiple sources (webhooks, queues, schedules) to rpa-elysium via proven-queueconn. RPA Elysium subscribes to a task queue and executes received events.

Both repos share the same ABI layer (proven-fsm state machines, proven-queueconn delivery guarantees) and Ephapax linear types for ownership safety.

Formally Verified Foundations

RPA Elysium consumes types from proven-servers:

  • proven-fsm — Workflow state machine with transition proofs (ProvenFSM.idr)

  • proven-queueconn — Queue connector with delivery guarantees (ProvenQueue.idr)

  • Ephapax linear types — Compile-time ownership enforcement (LinearDispatch.eph)

See ABI-FFI-README.md for full type mappings and architecture.

Monitoring Panels (PanLL)

Pre-built monitoring panels in panels/:

  • panels/fs-workflow/ — Workflow status, watch paths, rules, event timeline, FSM state diagram, queue connection status

  • panels/plugin-status/ — Loaded WASM plugins, sandbox memory, execution logs

Architecture

See TOPOLOGY.md for a visual architecture map and completion dashboard.