Skip to content
@tokenburner-ai

tokenburner-ai

Deploy a production SaaS into your AWS account in 7 minutes.

tokenburner

A small, low-cost AWS platform you install into your account.
Point an AI coding assistant at the stack repo and it does the rest.


What it is

A lightweight AWS stack plus a handful of drop-in features that all live behind one dashboard URL. Clone the stack repo, open it in an AI coding assistant, and about half an hour later you have:

  • a dashboard on CloudFront with one card per installed feature
  • a shared API-key store so every feature authenticates the same way
  • an admin console for creating users, issuing scoped AWS access keys, and managing per-user context

Most of that wall clock is CloudFront waiting for eventual consistency on each new distribution — there's nothing to actively babysit.

Idle cost with all features installed is about $1/month — Lambdas, CloudFront, DynamoDB on-demand, and a handful of small S3 buckets. No VPC, no NAT gateway, no load balancer in the default mode.

How you install it

  1. Get an AWS account and run aws configure. That's the only thing you need before starting.
  2. Clone tokenburner-ai/stack and open it in an AI coding assistant (one that reads CLAUDE.md — such as Claude Code or any other assistant that supports project-level context files).
  3. Say "install tokenburner." The assistant reads CLAUDE.md, checks your prerequisites, asks which features you want, bootstraps CDK if needed, and runs the real CLI (python3 tokenburner.py install). You approve the AWS deploys as they happen.
  4. Open the dashboard URL the install prints. Every feature card uses the same admin API key, which is cached at ~/.tokenburner/credentials.

If you prefer the command line, the same CLI runs without an assistant — no prompts, no .tokenburner.json to write, just:

git clone https://github.com/tokenburner-ai/stack.git && cd stack
pip install pyyaml --break-system-packages   # macOS Homebrew Python
python3 tokenburner.py install               # uses your AWS CLI defaults
# or pin the target explicitly:
python3 tokenburner.py install --profile myprofile --region us-east-2

The CLI auto-bootstraps CDK if your target region isn't ready, runs a Bedrock pre-flight before deploying chat, and prints a dashboard URL plus admin API key when it finishes.

Repositories

Repo Role
stack Base stack, dashboard, feature-registry contract, install CLI. Start here.
drive Personal file storage on S3 (Lambda + CloudFront + DynamoDB index).
chat AI chat with Bedrock streaming and DynamoDB-backed conversation history.
forums Threaded discussion board. Threads stored as JSON in S3 so AI assistants can read them directly.
agent Admin console for creating accounts, issuing scoped Bedrock access, and editing per-account or shared context.

Architecture at a glance

                           ┌──────────────────────────────────────┐
User → CloudFront (HTTPS) →│  Dashboard Lambda (one card/feature) │
                           └──────────────────────────────────────┘
                                          │
                                          ▼
                           ┌──────────────────────────────────────┐
                           │ Feature Registry DDB   API Keys DDB  │
                           └──────────────────────────────────────┘
                                          ▲
                 ┌────────────────────────┼────────────────────────┐
                 │                        │                        │
         Drive Lambda             Chat Lambda              Agent Lambda
         + CF + S3 + DDB          + CF + Bedrock + DDB    + CF + DDB
                 │                        │                        │
                 └──── self-register via custom resource ──────────┘

Each feature is an independent CDK stack. It imports the shared exports from the base, then writes one row to the feature-registry table on deploy. The dashboard reads that table and renders one card per row — that's the entire plugin model.

Design principles

  • Install, then forget. Dev mode runs on Lambda + CloudFront + DDB on-demand. Nothing costs money when idle.
  • AI-assistable by construction. Every repo has a CLAUDE.md or tokenburner.md that tells an AI coding assistant exactly what it's looking at and how to change it. Works with any assistant that reads project-level context — the stack doesn't depend on a specific vendor.
  • Features are repos. Adding one means copying drive as a template, renaming, and appending an entry to features.yaml.
  • Brand-neutral code. AI vendor names appear only in onboarding prose. The code, the API, and the Administration console name nothing specific — you can point any backend at the Agent feature.

tokenburner.ai

Popular repositories Loading

  1. stack stack Public

    Fork → deploy → build. Full SaaS stack on your AWS account in minutes.

    Python 1 1

  2. drive drive Public

    Token Drive — personal photo and document archive on AWS

    HTML

  3. .github .github Public

    Organization profile

  4. chat chat Public

    AI chat feature for the tokenburner stack (Bedrock streaming + DynamoDB history)

    Python

  5. forums forums Public

    Threaded discussion board for the tokenburner stack (S3-backed)

    Python

  6. agent agent Public

    Account + context administration for the tokenburner stack

    Python

Repositories

Showing 6 of 6 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…