Nebula Starter
https://github.com/jarrodwatts/nebula-starter- Category
- AI Agents
- Rank
- No. 2116Tools index
Previous survey · No. 2111 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- jarrodwatts
- GitHub
- 16 stars
- Date
About
Starter template for thirdweb Nebula to build on-chain AI agents.
What it does
Nebula Starter is a small TypeScript command-line example that creates a stateful chat session, asks a natural-language question about an NFT collection, and prints the answer. It supplies Thirdweb credentials and an EVM wallet account to Nebula, while limiting the example query to Abstract testnet.
Why it's ranked here
Its value comes from showing the whole connection in little code: credential checks, wallet creation, session memory, chain context, and a natural-language blockchain query. It also includes a transaction wrapper, though the default program demonstrates reading only. This is useful scaffolding, not a finished agent application.
What's good
The template validates all three required secrets before starting, which produces clearer failures than deferred authentication errors. Its read wrapper accepts caller overrides while providing configured client and account defaults. Session creation checks unsuccessful HTTP responses and includes the returned body in errors, making service failures easier to diagnose.
Tradeoffs
The example requires a raw EVM private key in local environment configuration, so secret handling needs care. Session creation uses a direct HTTP request and locally declared response types rather than the SDK. The default flow is fixed to one test network and one NFT question. No test or lint script is declared.
How to use it well
Use it when you already understand Node.js, have Thirdweb credentials, and want a compact proof of concept for conversational blockchain reads or wallet-backed execution. Replace the fixed prompt and chain context, then add your own interface, tests, secret management, and transaction safeguards. It does not provide a web UI, deployment setup, or production operations layer.
Technical notes+
src/index.ts validates configuration, creates a session, calls the read wrapper with abstractTestnet, and logs the result. src/thirdweb/nebulaRead.ts delegates to Nebula.chat, while src/thirdweb/nebulaExecute.ts wraps Nebula.execute; both inject defaults from src/thirdweb/thirdwebClient.ts and src/utils/createAccountFromPrivateKey.ts. src/thirdweb/nebulaCreateSession.ts posts directly to the Nebula session endpoint with the secret key, signer address, and Abstract testnet chain ID. src/utils/envCheck.ts checks the variables listed in .env.example. tsconfig.json enables strict TypeScript with NodeNext modules and ES2022 output. package.json builds with tsc; its start script compiles before running the emitted entry point.
Observed
- License
- ISC
- Primary language
- TypeScript
- Packaging and install surface
- Node.js ES module project installed with pnpm
- Interface
- Command-line example backed by the Thirdweb Nebula SDK and Nebula HTTP API
- Blockchain platform
- EVM wallet account with Abstract testnet configured in the example
- Build configuration
- Strict TypeScript targeting ES2022 with NodeNext modules
- Project scripts
- Build and start scripts are declared; no test or lint script is declared
Read from README.md, package.json, src/index.ts, src/utils/envCheck.ts, src/thirdweb/nebulaRead.ts, src/thirdweb/nebulaExecute.ts, src/thirdweb/thirdwebClient.ts, src/thirdweb/nebulaCreateSession.ts, src/utils/createAccountFromPrivateKey.ts, .env.example, tsconfig.json.
What it can do
Provide starter template for on-chain AI agents
Developer requirements and specifications → Preconfigured project template with thirdweb Nebula integration
Bootstrap blockchain-connected AI agent development
AI agent concept and blockchain parameters → Functional development environment for on-chain AI agents
Initialize smart contract integration for AI agents
Smart contract specifications and AI agent logic → Connected smart contract and AI agent framework
Generate boilerplate code for thirdweb Nebula projects
Project configuration settings → Ready-to-use codebase with thirdweb Nebula dependencies
Set up development environment for decentralized AI applications
Development preferences and blockchain network selection → Configured development workspace with necessary tools and libraries
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.