AmritaSense
"Sense is all you need."
AmritaSense is a general-purpose workflow orchestration engine that replaces traditional graph-based models with an instruction set architecture—treating workflows not as nodes-and-edges diagrams, but as programmable execution streams driven by a lightweight virtual machine.
Why AmritaSense?
Most workflow engines force you into a graph mindset: define nodes, connect edges, manage state objects. AmritaSense takes a different path. You compose nodes and control flow just like writing ordinary code—the engine compiles them into a linear instruction sequence, then executes them step by step. The result: zero scheduling overhead, native interrupt support, and the expressive power of assembly-level control flow.
Core Features
- Complete Instruction Set—
IF/ELIF/ELSE,WHILE/DO-WHILE,GOTO/CALL,TRY/CATCH/THEN/FIN,NOP,INTERRUPT. All control flow is first-class, not simulated through graph routing. - VM-Style Execution—A program counter (
PointerVector) and call stack drive execution. Jumps are integer operations, not graph traversals. - Native REPL Debugger—
from amrita_sense.debugger import *gives you breakpoints, stepping, and state inspection. Sync API for interactive REPL use (step,cont); async API (step_async,cont_async) for scripted debugging. Built atop the engine's Panic/Recover mechanism and composite middleware injection. - Async-Native Suspend/Resume—Two
Futurecallbacks enable full workflow interruption at any node boundary. Built for debuggers and human-in-the-loop systems. - Declarative Dependency Injection—Nodes declare dependencies via function signatures. The engine resolves them at runtime with type matching and concurrent resolution.
- Ultra Lightweight— Compiles 100,000 nodes in ~200ms. Runs anywhere from Raspberry Pi to cloud.
- Self-Compile Instructions—Extend the instruction set with
SelfCompileInstruction. Compile-time expansion, zero runtime overhead.
Installation
pip install amrita-sense
Quick Look
import asyncio
from amrita_sense import Node, WorkflowInterpreter as WorkflowPC, IF
@Node()
def condition() -> bool:
return True
@Node()
def action():
print("Done")
@Node()
def end():
print("End of workflow")
flow = IF(condition, action) >> end
pc = WorkflowPC(flow.render())
if __name__ == "__main__":
asyncio.run(pc.run())
See more demos in demos/
Documentation
Full guides, concept explanations, and API reference at sense.amritabot.com.
Contributing
Contributions are welcome. See CONTRIBUTING.md and our Code of Conduct.
License
Apache V2. See LICENSE.
AIGC Content Licensing Policy
AACLP V1. See POLICY_OF_AIGC (Official Link) for details.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file amrita_sense-0.7.0.tar.gz.
File metadata
- Download URL: amrita_sense-0.7.0.tar.gz
- Upload date:
- Size: 107.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
851aba0c600fd45428954159183aadebbdf920bafb8674c1ba6010a758d9da45
|
|
| MD5 |
4bf4415a4f1e52b8ed24568a17f7c66f
|
|
| BLAKE2b-256 |
bc98b425571ee73519e9fe749c20cb2d298a1f28ce06f883f3f698c466ee5a29
|
File details
Details for the file amrita_sense-0.7.0-py3-none-any.whl.
File metadata
- Download URL: amrita_sense-0.7.0-py3-none-any.whl
- Upload date:
- Size: 102.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
69a9694b3004c43561bec97eaf3b904bd7203441c904d9d903046c60a0d0de97
|
|
| MD5 |
78d35d66ee0963b76dc4f5a600818b5e
|
|
| BLAKE2b-256 |
2b5abe18daeaab0d06e50393cfb474df6e9eaa8833553b5e8b4461f52b6e1145
|
