Bikiran.Engine 1.7.1

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#
• 11 Built-in Node Types — start/end markers, 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
• Time-Weighted Progress — track live progress percentages weighted by each node's declared ApproxExecutionTime
• 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")
    .StartingNode("Flow is starting")
    .WaitingNode("Pausing briefly", TimeSpan.FromSeconds(1))
    .AddNode(new HttpRequestNode("call_api") {
        Url = "https://httpbin.org/get",
        OutputKey = "api_response"
    })
    .EndingNode("Flow completed successfully.")
    .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 License - see the LICENSE file for details.

👨‍💻 Author

Developed by Bikiran

• 🌐 Website: bikiran.com
• 📧 Email: Contact
• 🐙 GitHub: @bikirandev

<div align="center">

Made with ❤️ for the .NET community

⭐ Star this repo • 🐛 Report Bug • 💡 Request Feature

</div>

🏢 About Bikiran

Bikiran is a software development and cloud infrastructure company founded in 2012, headquartered in Khulna, Bangladesh. With 15,000+ clients and over a decade of experience, Bikiran builds and operates a suite of products spanning domain services, cloud hosting, app deployment, workflow automation, and developer tools.