🧪

11ku7-ai

Research Team Based in India

Exploring AI-assisted development tools, authentication systems, and code analysis technologies.

🇮🇳 India 🤖 AI Research 💻 Open Source

Current Project

🚀

11ku7-ai-nodecoder

AI Coding Tool For Hobbyists & Researchers

An autonomous AI developer with Agent Mode, MCP integration, GitHub support, and 22+ customizable themes. Generate, edit, and deploy code directly from your terminal.

View Project →

Learnings & Outcomes

🛠️ Technology Stack

Node.js

Runtime

Express.js

Web Framework

MongoDB

Database

JWT

Authentication

Socket.IO

Real-time Comm

Neo-Blessed

Terminal UI

Marked

Markdown Parser

Highlight.js

Syntax Highlighting

AI Providers: Gemini, OpenAI, Claude, Groq, Grok, OpenRouter, Ollama

🔐 Device Locking Mechanism

We implemented a secure device-locking system that ties contribution keys to specific devices, preventing unauthorized sharing while maintaining a smooth user experience.

How It Works:

  1. Device Fingerprint: Generate unique device identifier using hardware characteristics
  2. Login Identifier: Store device-username binding in MongoDB collection
  3. Token Validation: Each request validates both JWT token and device fingerprint
  4. Single Device Lock: One active login per user - switching devices requires logout

🎫 JWT Authentication

Implemented secure stateless authentication using JSON Web Tokens with automatic expiry handling and session management.

Token Features

  • 30-day expiry for contribution keys
  • 4-hour expiry for community keys
  • Automatic background validation
  • Secure key storage in .env

Security Measures

  • Bcrypt password hashing
  • Rate limiting (express-rate-limit)
  • CORS protection
  • Server-side session revocation

🔮 Holograph - Universal Code Analysis Engine

Our most innovative creation - the Holographic Lexer provides language-agnostic code analysis with intelligent symbol tracking and type inference.

Core Components

  • UniversalLexer: Polyglot tokenizer
  • FlowGraph: Symbol graph builder
  • Diagnostics: Unused/undefined detection
  • Linker: Cross-file resolution

Supported Languages

  • JavaScript / TypeScript
  • Python
  • Java / C / C++
  • Go / Rust / Ruby

Key Innovations:

  • 📊 Heap-based Symbol Tracking: Every definition gets a unique heap ID for refactoring
  • 🔗 Type Inference: Automatically detects types from constructors, assignments, and return values
  • 📍 JSDoc Parsing: Extracts @param, @returns, @type annotations
  • 🎯 Scope Boundary Detection: Tracks function/class boundaries for context-aware analysis
  • 🐍 Indentation Languages: Special handling for Python/YAML via virtual brace injection

🧠 ReAct Agent Architecture

The core of our Agent Mode - a ReAct (Reasoning + Acting) loop that enables autonomous task completion with intelligent decision-making.

Agent Loop Cycle:

  1. Observe: Gather context from project structure, memory, and external sources
  2. Think: Generate reasoning about the current state and next action
  3. Act: Execute a tool (file edit, shell command, search, etc.)
  4. Reflect: Evaluate result and update memory for next iteration

Key Features

  • Up to 500 autonomous steps in Auto Mode
  • Persistent session memory across turns
  • Efficiency protocol to prevent redundant actions
  • Scrutiny system for human-like decision making

Memory System

  • Hot memory: Active session cache
  • Persistent memory: Cross-session archival
  • Memory hydration from past turns
  • Relevant file detection from history

🔌 MCP (Model Context Protocol) Integration

Extend the agent's capabilities by connecting to external MCP servers for specialized tools and knowledge bases.

MCPClientManager

  • Multi-server connection management
  • StdioClientTransport for local servers
  • Auto server selection based on query
  • Generic tool invocation via schema

Capabilities

  • Memory persistence (store/retrieve)
  • External API access
  • Custom tool definitions
  • JSON schema argument building

Config: ~/.nodecoder/mcp-servers.json | SDK: @modelcontextprotocol/sdk

📄 PDF Vision Pipeline

A unique approach to PDF understanding - convert PDF pages to high-quality images and leverage vision models for analysis.

Pipeline Flow:

  1. PDF Attachment: User attaches PDF via /browse command
  2. Page Conversion: pdftoppm renders pages at 300 DPI with anti-aliasing
  3. Vision Analysis: Agent uses read_pdf_page_visual tool to request specific pages
  4. AI Interpretation: Vision model extracts text, diagrams, tables from image

Technical Details

  • Uses poppler-utils (pdftoppm)
  • 300 DPI high-quality rendering
  • Anti-aliasing enabled (-aa yes)
  • Supports multi-page PDFs

Why Vision over OCR?

  • Preserves layout and structure
  • Understands diagrams and charts
  • Handles complex formatting
  • No OCR library dependencies

🔍 Web Search Integration

Real-time web access for up-to-date information, documentation, and code examples.

Brave Search API

  • Privacy-focused search provider
  • Configurable result count
  • Returns title, URL, and snippets
  • 15-second timeout protection

Smart Search Routing

  • Auto-classifies query type
  • Routes to Exa MCP for code/docs
  • Falls back to Brave for general
  • Deep vs quick search modes

🛠️ Core Agent Tools

A comprehensive toolset enabling the agent to understand, navigate, and modify codebases autonomously.

📁 File Navigation

  • get_file_dependencies
  • load_file_full
  • apply_change_interactive
  • generate_edit_plan

🔎 Symbol Analysis

  • find_symbol_definition
  • find_symbol_references
  • holograph_diagnostics
  • parallel_explore

⚡ Execution

  • execute_shell
  • agent_terminal (persistent)
  • web_search / smart_search
  • read_pdf_page_visual

🐙 GitHub Integration

  • github_explore_repo
  • github_create_branch
  • github_create_pr
  • github_sync_changes

💬 Interaction

  • ask_user (consent prompts)
  • general_chat
  • provide_code_analysis
  • task_complete

🧩 Extensibility

  • Custom tools via agent.config.json
  • MCP server tools
  • Tool filtering by context
  • Dynamic tool registry

💰 Community Funding Model

We developed a sustainable dual-key funding system that balances accessibility with ongoing development support.

🔑 Community Keys

  • Free 4-hour universal access
  • Unlocked when funding goal reached
  • Available to everyone

🗝️ Contribution Keys

  • 30-day personal access
  • Device-locked security
  • Supports ongoing development