A professional-grade, privacy-first AI Image & Video generation studio

Features • Quick Start • Tech Stack • Docs • Contributing

• Node.js 18+
• npm 9+
• API keys from Google AI Studio and/or Venice.ai

# Clone the repository
git clone https://github.com/AbstergoSweden/image_app_01.git
cd image_app_01

# Install dependencies
npm install

# Configure environment
cp .env.example .env.local
# Edit .env.local with your API keys

# Start development server
npm run dev

Open http://localhost:3000 in your browser.

For automated setup (recommended for CI/new developers):

chmod +x setup_jules.sh
./setup_jules.sh

image_app_01/
├── 📁 .github/              # GitHub templates & workflows
│   ├── ISSUE_TEMPLATE/      # Bug report & feature request templates
│   └── PULL_REQUEST_TEMPLATE.md
├── 📁 e2e/                  # Playwright E2E tests
│   └── app.spec.ts
├── 📁 src/
│   ├── 📁 components/       # React UI components
│   │   ├── AuthScreen.tsx   # Login/registration with password strength
│   │   ├── ChatScreen.tsx   # AI chat interface
│   │   ├── Gallery.tsx      # Image gallery with pagination
│   │   ├── ImageGenScreen.tsx # Main generation interface
│   │   └── ...
│   ├── 📁 services/         # API clients & storage
│   │   ├── geminiService.ts # Google Gemini API
│   │   ├── veniceService.ts # Venice.ai API
│   │   ├── secureStorage.ts # Encrypted localStorage
│   │   └── blobStorage.ts   # IndexedDB for images
│   ├── 📁 utils/            # Helper functions
│   │   ├── crypto.ts        # Encryption utilities
│   │   ├── migrations.ts    # Data format migrations
│   │   └── passwordStrength.ts
│   ├── 📁 types/            # TypeScript definitions
│   ├── 📁 workers/          # Web Workers
│   ├── App.tsx              # Main application
│   └── main.tsx             # Entry point
├── 📄 index.html            # HTML shell
├── 📄 vite.config.ts        # Vite + PWA configuration
├── 📄 tsconfig.json         # TypeScript configuration
├── 📄 eslint.config.js      # ESLint flat config
├── 📄 playwright.config.ts  # E2E test configuration
└── 📄 package.json          # Dependencies & scripts

Create a .env.local file (or set in your deployment):

# Google Gemini API Key
# Get one from: https://aistudio.google.com/apikey
GEMINI_API_KEY=your_gemini_key_here

# Venice.ai API Key
# Get one from: https://venice.ai/settings/api
VENICE_API_KEY=your_venice_key_here

💡 Tip: API keys can also be entered directly in the app's Settings screen.

This application follows security best practices:

• Client-side encryption: All user data is encrypted with AES-GCM before storage
• PBKDF2 key derivation: Passwords are never stored; they derive encryption keys
• Password strength: Registration requires minimum strength score (zxcvbn)
• No telemetry: Zero data sent to external servers (except AI API calls)
• CSP-ready: Content Security Policy compatible architecture

See SECURITY.md for vulnerability reporting.

npm run test           # Run once
npm run test:watch     # Watch mode

# Install Playwright browsers (first time only)
npx playwright install chromium

# Run E2E tests
npm run test:e2e

# Run with UI
npm run test:e2e:ui

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Run npm run preflight to verify
5. Commit (git commit -m 'Add amazing feature')
6. Push (git push origin feature/amazing-feature)
7. Open a Pull Request

• Large bundle size (~1.3MB) - consider code splitting
• Some components use any types - TypeScript strict mode pending
• State management is prop-drilling - consider Zustand/Jotai for scale

• Code splitting for faster initial load
• Full TypeScript strict mode compliance
• State management refactor (Zustand)
• Cloud sync option (optional, encrypted)
• Mobile app (React Native / Capacitor)

This project is licensed under the MIT License - see LICENSE for details.

Built with ❤️ for the AI art community

Report Bug • Request Feature