Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/seangeng/based-adventure
Farcaster Frames Text-based Adventure on the Base L2
https://github.com/seangeng/based-adventure
farcaster farcaster-frames farcaster-protocol openai
Last synced: 8 days ago
JSON representation
Farcaster Frames Text-based Adventure on the Base L2
- Host: GitHub
- URL: https://github.com/seangeng/based-adventure
- Owner: seangeng
- Created: 2024-01-27T18:59:46.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-02-17T11:20:00.000Z (10 months ago)
- Last Synced: 2024-02-17T12:26:36.081Z (10 months ago)
- Topics: farcaster, farcaster-frames, farcaster-protocol, openai
- Language: TypeScript
- Homepage: https://basequest.ai
- Size: 23.1 MB
- Stars: 38
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-frames - Based adventure
README
# Base Quest
This is an experimental Farcaster frame app for an AI text-based adventure powered by the Base L2.
Base Quest is still a work in progress and subject to change.
# Want to play?
Follow me on Farcaster for the latest game link: https://warpcast.com/seangeng
## Features
- AI Driven Gameplay ✅
- Leaderboard ✅
- Option to continue vs start a new game ✅
- Issue Character NFTs on Base & save state to them ✅
- Notifications
- Character attributes
- Game backgrounds & environments (✅ testing)
- $EXP Tokens
- Character profile links & PvP (✅ testing)
- Multi-player quests
## How it Works
This high level diagram explains the frame states & how menu actions are managed generically.
Buttons can be passed to the menu in the GET parameter, and map to the business logic - essentially acting as a router.
Several awesome SDKs & frameworks are leveraged to accelerate developement:
Coinbase OnChain Kit: For frame helpers & future onchain actions.
- https://github.com/coinbase/onchainkit
Neynar: Making it easy to interact with Farcaster
- https://neynar.com/
OpenAI: For chat completions & image generation.
- https://openai.com
Inngest: For executing background jobs (there is latency when generating images + certain onchain actions)
- https://www.inngest.com/
Vercel: For hosting, and easy programmatic OpenGraph image generation:
- Check out `/src/app/api/image/prompt/route.tsx` as an example
- https://vercel.com/docs/functions/edge-functions/og-image-generation/og-image-examples
### Basic AI Workflow
Base Quest uses the OpenAI GPT 3.5 Turbo model to narrate & continue the storyline.
That means each user's journey is completely unique!
Check out the `/src/app/api/prompt/route.tsx` file to see how the AI prompt loop works:
1. AI generates the prompt & button options
- system: You are the narrator in a choose your own adventure text-based game.
- The user is a {class} starting their first adventure.
- Write a character narration prompt (up to 100 characters), and present the user with either 2 or 4 action options to continue the story.
- Action options should be either emoji(s) or short button text (up to 14 characters)
- Return a JSON response like so: { }
2. Present options as next frame og:buttons
3. Feed the previous prompt & user selected action to the next prompt screen
### Onchain Interactions
To avoid timeouts and for better resiliency - Inngest is leveraged to run serverless jobs async & in the background.
This pattern has better monitoring, auto-retrys, and decouples business logic from the frame rendering.
Check out `/src/app/inngest/functions.tsx` to see how this works.
We use the InstaMint.sol contract - developed by my team at Coinbase & optimized for gas & ease of use!
The NFT factory contract is available at:
Sepolia Testnet: `0x4d64cAc5Bd09c7CaC9748D1E5a63A30Ee40B6A40`
Base Mainnet: `0x85db63af3f0cfac7813abb4dfca6d713e937a5dd`
### Want to build onchain?
The future is onchain. Does this interest you? Do you think you can do better?
Coinbase hires the top 1% of developers - reach out to me for a possible referral: https://www.linkedin.com/in/seangeng/