Bikiran.Engine 1.4.0

Bikiran.Engine

Bikiran.Engine is a workflow automation engine for .NET 8 applications. It lets you chain together multiple steps — HTTP calls, emails, database queries, conditions, loops, and custom logic — into automated background flows that run inside your own app.

Think of it as n8n or Zapier embedded directly inside your .NET application, sharing your database, services, and HTTP pipeline.

Features

• Fluent Builder API — build workflows by chaining method calls in C#
• 9 Built-in Node Types — HTTP requests, emails, conditions, loops, retries, parallel execution, and more
• Background Execution — flows run asynchronously without blocking the caller
• Persistent Logging — every step is recorded in the database with timing and error details
• Lifecycle Events — run handlers on success, failure, or always after a flow completes
• Reusable JSON Definitions — save flow templates as JSON and trigger them without redeploying code
• Scheduled Execution — run flows on a cron schedule, at fixed intervals, or at a specific future time
• Custom Nodes — create your own node types for any business logic
• Named Credentials — register SMTP or API credentials once and reference them by name
• Admin REST API — monitor, manage, and trigger flows through built-in endpoints
• Auto Database Migration — schema is created and updated automatically on startup

Installation

dotnet add package Bikiran.Engine

Quick Setup

1 — Register Services

In Program.cs:

builder.Services.AddBikiranEngine(options =>
{
    options.ConnectionString = builder.Configuration.GetConnectionString("Default");
});

Note: You must also register your EF Core database provider (e.g., AddMySql, AddNpgsql, or AddSqlServer) and pass it to AddBikiranEngine. See the Getting Started guide for details.

2 — Map Admin Endpoints

app.MapBikiranEngineEndpoints();

That's it. On first startup, all required database tables are created automatically.

Your First Flow

var serviceId = await FlowBuilder
    .Create("my_first_flow")
    .AddNode(new WaitNode("pause") { DelayMs = 1000 })
    .AddNode(new HttpRequestNode("call_api") {
        Url = "https://httpbin.org/get",
        OutputKey = "api_response"
    })
    .StartAsync();
// Returns immediately — the flow runs in the background

Built-in Node Types

Full Setup Example

builder.Services.AddBikiranEngine(options =>
{
    options.ConnectionString = builder.Configuration.GetConnectionString("Default");
    options.DefaultMaxExecutionTime = TimeSpan.FromMinutes(10);
    options.EnableNodeLogging = true;

    options.AddCredential("smtp_primary", new SmtpCredential
    {
        Host = "smtp.example.com",
        Port = 587,
        Username = "noreply@example.com",
        Password = builder.Configuration["Smtp:Password"],
        UseSsl = true
    });
});

app.MapBikiranEngineEndpoints();

Documentation

Admin API Endpoints

All routes are under /api/bikiran-engine/:

Flow Runs — /runs

Flow Definitions — /definitions

Flow Schedules — /schedules

License

MIT © Bikiran Dev