intent-bus

Intent Bus is a lightweight, zero-infrastructure job coordination system designed to simplify the execution of scripts across multiple devices. It provides a solution to run code from anywhere using simple HTTP requests, minimizing the need for complex setups like Redis or RabbitMQ, and is particularly beneficial for developers seeking reliable task management without significant overhead.

Key Features

• Cross-Device Automation: Trigger jobs on devices such as Android phones directly from cloud servers without the necessity of open ports.
• Job Management: Automatically handle job execution with retries, atomic locking, priority scheduling, and a dead-letter queue to ensure failed jobs are preserved for later inspection.
• RESTful Interface: Utilize a straightforward HTTP-based API for submitting jobs, making it compatible with various programming environments.

How It Works

1. Clients POST a job to the /intent endpoint.
2. Workers poll the /claim endpoint.
3. A worker claims the job atomically and proceeds to fulfill it by calling /fulfill/<id>.
4. If a job fails, it is retried using exponential backoff, and jobs that exceed retry limits are archived in a dead-letter queue.

Unique Advantages

Intent Bus stands out due to its ability to deploy with minimal operational complexity. Unlike traditional job schedulers or message brokers, it enables:

• Direct HTTP triggering for seamless integration across environments.
• Priority Queues that allow critical jobs to be prioritized for execution.
• Capability Routing, ensuring workers only take on jobs they are equipped to handle.
• No external broker is required, keeping deployments lightweight and low-maintenance.

Use Cases

Intent Bus is particularly suited for:

• Developers managing scripts across numerous machines.
• Users of Android automation through Termux.
• Indie developers needing to minimize infrastructure complexity.
• Anyone seeking effective job queue systems without the intricacies associated with heavier solutions like Redis or RabbitMQ.

First Steps with Intent Bus

Engaging with Intent Bus can be done seamlessly, whether through the Command Line Interface (CLI) or via a Python SDK, enabling:

• Publishing jobs with custom payloads and priorities.
• Deploying workers that handle specific job types efficiently.

Example Usage with CURL

Publish a job:

curl -X POST https://your-bus.render.com/intent \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_key_here" \
  -d '{"goal":"send_notification","payload":{"instruction":"Hello"}}'

Authentication Support

Intent Bus supports multiple authentication methods, including standard API key authentication and more stringent HMAC-based verification for enhanced security, ensuring that access to job execution is controlled and monitored effectively.

Conclusion

In summary, Intent Bus offers a modern alternative to existing job scheduling systems, eliminating unnecessary complexity while ensuring reliable delivery of tasks. This makes it an excellent choice for developers and hobbyists alike who need a flexible, maintainable solution for distributed job management.