ooWaa.ai

Version: 1.0.0
Last Updated: 2026-02-04

The AI reformer. Knows what it doesn't. Teams with you to get it right.

The hum&ai aligned discussion

The AI and the human work as a team to get results through structured aligned discussions.

The prompt is part of a structured aligned discussion called hum&ai, where the AI and the human work as a team to get results.

The discussion runs in threads (lines of thought), with strolls (a sequence of request-response iterations on a topic) possibly broken into sections (a subtopic stroll) and if needed, further broken into parts.

This way, without losing information, long detailed responses are cut up into short parts, each discussed in several aligned iterations, proceeding at a human pace.

The discussion produces (or updates) a brief and concise HOCON report to support the hum&ai process.

Planned threads: The remainder of topics not discussed yet, in this and other threads is remembered and maintained with alignment discussions.

🏗️ Project Structure

See devDocs/TechSetup.md for the full directory layout and tech stack details.

🚀 Tech Stack

Frontend

• React Native - Mobile application framework
• Expo - React Native development platform
• React Navigation - Navigation library

Backend

• Node.js - JavaScript runtime
• NATS.io - Message broker for microservices communication
• LangChain - Framework for developing LLM applications
• LangGraph - Library for building stateful, multi-actor applications

📋 Prerequisites

• Node.js >= 18.0.0
• npm >= 9.0.0
• (Optional) NATS server for local development
• (Optional) Expo Go app on your mobile device

🛠️ Setup Instructions

1. Clone the Repository

git clone https://github.com/pashute/BinAI.ai.git
cd BinAI.ai

2. Install Dependencies

npm install

This will install dependencies for the root, frontend, and backend workspaces.

3. Configure Environment Variables

cd backend
cp .env.example .env

Edit .env and add your API keys:

• OPENAI_API_KEY - For LangChain/OpenAI integration
• NATS_SERVER - NATS server URL (default: nats://localhost:4222)

4. Run the Application

From the root directory:

npm run dev

This will start both the humandBrain backend and humANDai frontend concurrently:

• humandBrain: Runs on port 4222 (NATS) / 3000 (default)
• humANDai: Expo dev server (Metro bundler)

Individual Commands

# Start only backend
npm run dev:humandBrain

# Start only frontend
npm run dev:humANDai

# Clean all dependencies and build artifacts
npm run clean

🌐 Development with GitHub Codespaces

This project is configured for GitHub Codespaces with VSCode:

1. Open the repository in GitHub Codespaces
2. The devcontainer will automatically set up the environment
3. English locale and Windows-compatible terminal settings are pre-configured
4. GitHub Copilot extensions are included

Port Forwarding

The following ports are automatically forwarded:

• 8081 - Expo Metro bundler
• 3000 - Backend API (if used)
• 4222 - NATS server

📱 Running on Mobile Device

1. Install Expo Go app on your device
2. Start the dev server: npm run dev
3. Scan the QR code shown in terminal with:
   • iOS: Camera app
   • Android: Expo Go app

🔧 Configuration Files

Codespace/VSCode Settings

• .devcontainer/devcontainer.json - Codespace configuration
• .devcontainer/Dockerfile - Container definition
• English locale and Windows terminal preferences included

Frontend Configuration

• frontend/app.json - Expo app configuration
• frontend/babel.config.js - Babel transpiler configuration

Backend Configuration

• humandBrain/.env - Environment variables (create from .env.example)

📦 NPM Scripts

Root Level

• npm run dev - Run both frontend and backend concurrently
• npm run dev:humandBrain - Run only backend
• npm run dev:humANDai - Run only frontend
• npm run install:all - Install all dependencies
• npm run clean - Clean all workspaces

Backend

• npm run dev --workspace=humandBrain - Run backend with hot reload
• npm run start --workspace=humandBrain - Run backend in production mode

Frontend

• npm run start --workspace=humANDai - Start Expo dev server
• npm run android --workspace=humANDai - Run on Android emulator
• npm run ios --workspace=humANDai - Run on iOS simulator
• npm run web --workspace=humANDai - Run as web app

🔐 Environment Variables

See humandBrain/.env.example for all available environment variables.

Required for full functionality:

• OPENAI_API_KEY - OpenAI API key for LangChain
• NATS_SERVER - NATS messaging server URL

🤝 Contributing

Details will be provided after initial requirements gathering.

📄 License

Details will be provided.

🗺️ Roadmap

More features and requirements will be added as the project evolves.

See DevDocs/Frontend/features.app.md and DevDocs/Backend/features.brain.md for current feature plans.

Note: This is an initial setup. Detailed Requirements and features will be implemented in subsequent iterations.