🔥 Ember — AI + Web3 Financial Discipline Platform

Build discipline that sticks. Backed by real stake. Verified on-chain.

---

🎯 The Problem

Financial discipline fails for one reason. There is no consequence for quitting.

Goals are free to set. Promises cost nothing to break. So we break them. Quietly. Repeatedly. Until we stop trying. What's missing is a system where commitment carries weight, inconsistency has a cost you can feel, and showing up every day actually matters.

---

💡 Our Solution

Ember combines conversational AI with Web3 incentives to make financial discipline feel like something worth protecting.

• AI that understands you. Voice conversations build your Psychological Financial Profile.
• Real stake. Real consequences. Deposit funds. Missed days deduct. Perfect consistency returns everything plus bonus.
• Streak protection. Slip up? Your streak survives. Your wallet absorbs the fall.
• Proof of Discipline. Earn soulbound tiers from Bronze to Diamond. Verifiable on-chain.
• Social accountability. Private pools where friends stake together and share consequences.

---

Talk Page

## Talk Page Report

Vault Page

Dashboard Page

Commitment Page

Commitment Strategy AI

Pool Page

Drops Page

🏗️ System Architecture

User Entry → AI Profile → Commitment → Blockchain → Verification → Reward → Return Deposit + Yield

Layer	Technology	Purpose
Frontend	React 19 + TypeScript + Vite	Component architecture
Styling	Tailwind CSS + shadcn/ui	Design system
Motion	GSAP + Lenis + Framer Motion	Smooth scroll and animations
3D	React Three Fiber + Drei	Companion rendering
Web3	MetaMask + ethers.js v6	Wallet and transactions
Blockchain	Solidity + Hardhat + OpenZeppelin	Smart contracts
AI	OpenRouter + GPT-4o + Web Speech API	Conversational intelligence
Storage	IPFS + LocalStorage	Metadata and preferences

---

🚀 Quick Start

Prerequisites

• Node.js 18+
• MetaMask browser extension
• Git

Installation

# Clone the repository
git clone https://github.com/yourusername/ember.git
cd ember

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Add your OpenRouter API key to .env.local

Run Locally (Free Mode)
bash
npm run dev
Visit http://localhost:5173

Run with Blockchain (Full Experience)
Terminal 1 — Start local Hardhat node

bash
npm run node
Terminal 2 — Deploy contracts

bash
npm run deploy:local
Terminal 3 — Start frontend

bash
npm run dev

Project Structure

ember/
├── contracts/               # Solidity smart contracts
│   ├── contracts/
│   │   ├── EmberVault.sol   # Staking and tier logic
│   │   ├── TamashiiNFT.sol  # Soulbound discipline badge
│   │   └── KizunaPool.sol   # Group accountability pools
│   ├── scripts/
│   │   └── deploy.ts        # Deployment script
│   └── hardhat.config.ts    # Hardhat configuration
├── src/
│   ├── components/          # React components
│   ├── pages/               # Page routes
│   ├── web3/                # Web3 integration
│   ├── contracts/           # Deployed addresses
│   └── styles/              # Global styles
├── public/                  # Static assets
└── package.json             # Dependencies