Package: starburst 0.3.9

Scott Friedman

starburst: Seamless AWS Cloud Bursting for Parallel R Workloads

A 'future' backend that enables seamless execution of parallel R workloads on 'Amazon Web Services' ('AWS', <https://aws.amazon.com>), including 'EC2' and 'Fargate'. 'staRburst' handles environment synchronization, data transfer, quota management, and worker orchestration automatically, allowing users to scale from local execution to 100+ cloud workers with a single line of code change.

Authors:Scott Friedman [aut, cre]

starburst_0.3.9.tar.gz
starburst_0.3.9.zip(r-4.7-any)starburst_0.3.9.zip(r-4.6-any)starburst_0.3.9.zip(r-4.5-any)
starburst_0.3.9.tgz(r-4.6-any)starburst_0.3.9.tgz(r-4.5-any)
starburst_0.3.9.tar.gz(r-4.7-any)starburst_0.3.9.tar.gz(r-4.6-any)
starburst_0.3.9.tgz(r-4.6-emscripten)
manual.pdf |manual.html
DESCRIPTION |NEWS
card.svg |card.png
starburst/json (API)

# Install 'starburst' in R:
install.packages('starburst', repos = c('https://scttfrdmn.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/scttfrdmn/starburst/issues

Pkgdown/docs site:https://starburst.ing

On CRAN:

Conda:

7.37 score 11 stars 38 scripts 335 downloads 20 exports 37 dependencies

Last updated from:09a7fbb6e1. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-x86_64OK169
source / vignettesOK210
linux-release-x86_64OK150
macos-release-arm64OK110
macos-oldrel-arm64OK86
windows-devel-x86_64OK104
windows-release-x86_64OK115
windows-oldrel-x86_64OK98
wasm-releaseOK121

Exports:starburststarburst_check_quota_requeststarburst_cleanup_ecrstarburst_clusterstarburst_configstarburst_estimatestarburst_is_configuredstarburst_list_sessionsstarburst_logsstarburst_mapstarburst_quota_statusstarburst_rebuild_environmentstarburst_request_quota_increasestarburst_sessionstarburst_session_attachstarburst_setupstarburst_setup_ec2starburst_statusStarburstBackendStarburstFuture

Dependencies:askpassbase64encclicodetoolscrayoncurldigestfutureglobalsgluehttr2jsonlitelifecyclelistenvmagrittropensslparallellypaws.commonpaws.computepaws.cost.managementpaws.managementpaws.security.identitypaws.storageprocessxpsqs2R6RcppRcppParallelrenvrlangstringfishsysuuidvctrswithrxml2

Getting Started with staRburst
Introduction | Which API should I use? | Which backend? EC2 (default) vs Fargate | How it works (the mental model) | Installation | One-Time Setup | Your first job | Migrating existing future / furrr code | Real-world examples | Working with Data | Data Already in S3 | Uploading Local Data | Large Data Optimization | Cost Management | Estimate Costs | Set Cost Limits | Cost estimates | Quota Management (Fargate backend) | Check Your Quota | Request Quota Increase | Wave-Based Execution | Troubleshooting | View Worker Logs | Check Cluster Status | Common Issues | Best Practices | 1. Use for Right-Sized Workloads | 2. Batch Small Tasks | 3. Use S3 for Large Data | 4. Set Reasonable Limits | 5. Clean Up | Advanced: Custom Configuration | CPU and Memory | Timeout | Region | Next Steps | Getting Help

Last update: 2026-07-22
Started: 2026-02-03

Detached Session Mode
Detached Sessions | Why Use Detached Sessions? | Basic Usage | Creating a Session | Checking Status | Collecting Results | Detach and Reattach | Session Management | List All Sessions | Extend Timeout | Cleanup | Choosing and tuning the backend | Advanced Usage | Error Handling | Partial Collection | How It Works | Architecture | Task Lifecycle | Best Practices | When to Use Detached Sessions | Resource Management | Cost Optimization | Comparison: Ephemeral vs Detached | Troubleshooting | Session Not Found | No Results After Long Wait | Workers Terminating Too Soon | Examples | Genomics Pipeline | Monte Carlo Simulation | See Also

Last update: 2026-07-22
Started: 2026-02-06

Example: Bootstrap Confidence Intervals for A/B Testing
Overview | The Problem | Setup | Generate Sample Data | Bootstrap Function | Local Execution | Cloud Execution with staRburst | Results Analysis | Visualization | Performance Comparison | Advanced: Multi-Metric Bootstrap | When to Use This Pattern | Running the Full Example | Next Steps

Last update: 2026-07-22
Started: 2026-02-04

Example: Parallel Bulk API Calls
Overview | The Problem | Setup | API Call Function | Mock API for Demo | Generate Sample Data | Local Execution | Cloud Execution with staRburst | Results Processing | Performance | Rate Limiting Considerations | Error Handling Best Practices | When to Use This Pattern | Running the Full Example | Next Steps

Last update: 2026-07-22
Started: 2026-02-04

Example: Parallel Feature Engineering
Overview | The Problem | Setup | Generate Sample Data | Feature Engineering Function | Local Execution | Cloud Execution with staRburst | Results Analysis | Performance Comparison | Advanced: Adding ML-Ready Features | When to Use This Pattern | Running the Full Example | Next Steps

Last update: 2026-07-22
Started: 2026-02-04

Example: Parallel Geospatial Analysis
Overview | The Problem | Setup | Generate Sample Data | Spatial Analysis Function | Local Execution | Cloud Execution with staRburst | Results Analysis | Performance Comparison | Advanced: Delivery Zone Optimization | When to Use This Pattern | Running the Full Example | Next Steps

Last update: 2026-07-22
Started: 2026-02-04

Example: Parallel Grid Search for Hyperparameter Tuning
Overview | The Problem | Setup | Generate Sample Data | Define Parameter Grid | Model Training Function | Local Execution | Cloud Execution with staRburst | Results Analysis | Performance | Advanced: Random Search | Advanced: Bayesian Optimization | When to Use This Pattern | Running the Full Example | Next Steps

Last update: 2026-07-22
Started: 2026-02-04

Example: Parallel Portfolio Risk Modeling
Overview | The Problem | Setup | Generate Sample Portfolio | Risk Scenario Generation | Portfolio Valuation Function | Local Execution | Cloud Execution with staRburst | Risk Metrics Analysis | Performance | Advanced: Incremental Risk Analysis | When to Use This Pattern | Running the Full Example | Next Steps

Last update: 2026-07-22
Started: 2026-02-04

Example: Parallel Report Generation
Overview | The Problem | Setup | Report Template | Generate Sample Data | Report Generation Function | Local Execution | Cloud Execution with staRburst | Results Processing | Performance | Advanced: Custom Report Distribution | When to Use This Pattern | Running the Full Example | Next Steps

Last update: 2026-07-22
Started: 2026-02-04

Performance Guide: When to Use Cloud vs Local
The Honest Truth | Real Performance Data | ✅ When it pays off — heavy per-task work | ❌ When it doesn't — light per-task work | The lesson | Per-Task Overhead | Batching | Choosing Instance Types | The Startup Cost Problem | Run once (cold) — modest win | Run 10 times (parameter sweep) — much better | Daily recurring job — excellent | Decision Framework | Common Patterns | Pattern: One-shot analysis — use local | Pattern: Parameter sweep — use cloud | Pattern: Daily production job — keep warm pool | Pattern: Hybrid — develop local, scale on cloud | Cost Estimation | Common Pitfalls | Use Case Quick Reference | AWS Authentication

Last update: 2026-07-22
Started: 2026-03-22

Example: Monte Carlo Portfolio Simulation
Overview | The Problem | Setup | Simulation Function | Local Execution | Cloud Execution with staRburst | Results Analysis | Performance | When to Use This Pattern | Running the Full Example | Next Steps

Last update: 2026-07-21
Started: 2026-02-04

Workload Shapes: When (and How) to Use staRburst
Lever 1 — Task length: is each task worth shipping? | Lever 2 — Task count: batch, or fall off a cliff | Lever 3 — Fan-out width: more workers is not always better | Lever 4 — Cost vs. time: what are you optimizing? | Pro tip — shard your S3 writes across prefixes | Putting it together: a diagnosis checklist

Last update: 2026-07-21
Started: 2026-07-21

Troubleshooting staRburst
Accessing Logs | CloudWatch Logs Structure | Viewing Logs in R | Viewing Logs in AWS Console | Common Issues | Issue 1: Tasks Stuck in "Pending" | Issue 2: Workers Crash Immediately | Issue 3: "Access Denied" Errors | Issue 4: High Costs / Runaway Workers | Issue 5: Session Cleanup Not Working | Issue 6: Results Not Appearing | Issue 7: Detached Session Reattach Fails | Issue 8: Package Installation Failures | Advanced Diagnostics | Checking ECS Task Status | Monitoring S3 Storage | Estimating Costs | Getting Help | See Also

Last update: 2026-07-21
Started: 2026-02-12

Security Best Practices for staRburst
1. Credential Management | ❌ DON'T: Hard-code Credentials | ✅ DO: Use IAM Roles (Recommended) | ✅ DO: Use Named Profiles (Local Development) | ✅ DO: Use Temporary Credentials (STS) | 2. S3 Bucket Security | Minimum Required Permissions | Enable Server-Side Encryption | Enable Versioning | Block Public Access | Use Bucket Policies | 3. Network Isolation | Use Private Subnets (For Sensitive Workloads) | Configure Security Groups | Enable VPC Endpoints (Recommended) | 4. Cost Controls | Set Budget Alerts | Use Worker Limits | Monitor Active Sessions | Use Absolute Timeouts | Cost Estimation | 5. Audit Logging | Enable CloudTrail | Enable CloudWatch Logs | Enable S3 Access Logging | Review Security Events | 6. Data Protection | Minimize Data Uploaded to S3 | Delete Results After Collection | Consider Client-Side Encryption | 7. Container Image Security | Use Minimal Base Images | Scan Images for Vulnerabilities | Use Image Lifecycle Policies | 8. Compliance Considerations | HIPAA Compliance | GDPR Compliance | SOC 2 Compliance | 9. Incident Response | If Credentials Are Compromised | If Data Breach Suspected | 10. Security Checklist | Additional Resources | See Also

Last update: 2026-02-12
Started: 2026-02-12

Readme and manuals

Help Manual

Help pageTopics
Create a Future using Starburst Backendfuture.starburst
Launch a future on the Starburst backendlaunchFuture.StarburstBackend
List futures for StarburstBackendlistFutures.StarburstBackend
Number of workers for StarburstBackendnbrOfWorkers.StarburstBackend
staRburst Future Backendplan.starburst
Print method for session statusprint.StarburstSessionStatus
Check if StarburstFuture is Resolvedresolved.StarburstFuture
Get Result from StarburstFutureresult.StarburstFuture
Run a StarburstFuturerun.StarburstFuture
Detached Session APIsession-api
Starburst strategy markerstarburst
Monitor quota increase requeststarburst_check_quota_request
Clean up staRburst ECR imagesstarburst_cleanup_ecr
Create a Starburst Clusterstarburst_cluster
Configure staRburst optionsstarburst_config
Estimate Cloud Performance and Coststarburst_estimate
Check if staRburst is configuredstarburst_is_configured
List All Sessionsstarburst_list_sessions
View worker logsstarburst_logs
Map a Function Over Data on AWS Workersstarburst_map
Show quota statusstarburst_quota_status
Rebuild environment imagestarburst_rebuild_environment
Request quota increase (user-facing)starburst_request_quota_increase
Create a Detached Starburst Sessionstarburst_session
Reattach to Existing Sessionstarburst_session_attach
Setup staRburststarburst_setup
Setup EC2 capacity providers for staRburststarburst_setup_ec2
Show staRburst statusstarburst_status
Starburst Future BackendStarburstBackend