GEMINI_2.0_FLASH INTEGRATION

AI-Native Study
Infrastructure
for Engineering.

Direct Gemini AI integration for your syllabus. No new GUI to learn—just a powerful WhatsApp or Telegram bot for academic mastery directly in your workflow.

Initialize Instance
$ git clone https://github.com/roshan30-git/picoclaw-scholar.git
Open Source E2E Encrypted <50ms Latency
user@studyclaw: ~/picoclaw-scholar
git clone https://github.com/roshan30-git/picoclaw-scholar.git
cd picoclaw-scholar
go mod tidy
Downloading dependencies... [====================] 100%
✓ Dependencies resolved.

go run cmd/main.go
@Gemini_Pro: System initialized. WhatsApp bridge active.
_
Ready UTF-8
Ln 24, Col 2

Powered By

Gemini 2.0 Flash Free & Open Source
99.9%
Uptime
<50ms
Latency
~30MB
RAM
AES-256
Security

Core Modules

Essential components for your academic stack. Built for performance, reliability, and developer experience.

CORE

Smart Message Routing

Intelligent handling: short messages are silently indexed, while long texts are AI-summarized into concise bullets.

Real-time Web Search

Instant internet lookups via DuckDuckGo without any API keys. Automated access to current events and fresh data.

PDF & Image Ingestion

Drop curriculum files directly in WhatsApp or Telegram. Fully indexed for instant retrieval and RAG search.

Adaptive Quizzes

Generates MCQs from your own notes, adapting dynamically to your weak topics based on historical quiz performance.

Excel Export

Need structured data? Request your tracked deadlines or quiz history to be exported seamlessly as .xlsx files.

Diagrams & Circuits

Render complex flowcharts, ER diagrams, mindmaps, and electrical circuit schematics viewable in the local web server.

NEW

Dynamic Student Memory

A persistent AI profile tracking your pacing, weak points, and study style, injecting deep personalization into every reply.

Proactive Reminders

Automated cron scheduler firing off 8 AM deadline briefings and Sunday morning flashcard generation.

Passive Group Privacy

Read-only college group monitoring. The agent indexes information silently and sends responses privately to the owner.

TELEGRAM

Native Telegram Bot

Full support for Telegram bots. Ultra-stable, high-performance channel for those who prefer an optimized messaging experience.

Zero-Setup Windows Installation

One-Command Launch (Windows)

StudyClaw is natively designed to be completely setup-free on Windows using its unified PowerShell orchestrator script. No C++ compilers required.

Requirements

Ensure you have the Go compiler installed. Then, download or clone the repository into your desired working folder.

Launch the Orchestrator

Open PowerShell in the folder and execute the interactive launcher script. It will auto-resolve dependencies, configure your environment file interactively, and launch the engine directly.

> .\run.ps1

Premium Frictionless Setup

Experience a high-end Glassmorphism UI with automated OAuth. Connect Google (Drive/Classroom) and ChatGPT Pro with one click—no manual JSON pasting required!

Installation complete! Message the bot "Hi" on Telegram to begin.
Termux Installation Guide (Mobile)

Step-by-Step Setup for Android

Run the bot directly on your phone using Termux. No server required. All you need is a free Gemini API key.

1

Install Termux & Prerequisites

Download Termux from F-Droid (do not use the Play Store version). Open it and run the following commands to install Go, Git, and Clang:

# Update packages and install prerequisites
$ pkg update && pkg upgrade -y
$ pkg install golang git clang make -y
2

Clone the Repository

Download the StudyClaw base image and configure the workspace environment dependencies.

$ git clone https://github.com/roshan30-git/picoclaw-scholar.git
$ cd picoclaw-scholar
$ go mod tidy
3

Configure API Keys

Get your free Gemini key at Google AI Studio. Set it as an environment variable in Termux.

$ export GEMINI_API_KEY="AIzaSy..."
# Optional: Set your own number to access admin tools
$ export STUDYCLAW_OWNER_NUMBER="91XXXXXXXXXX"
4

Launch and Link WhatsApp

Run the bot! A QR code will display in the terminal. Open WhatsApp on your primary phone, go to Linked Devices, and scan it.

$ go run cmd/main.go
Installation complete! Message the bot "Hi" on WhatsApp to begin.

How We Compare

Why students choose sovereign infrastructure over generic AI chat.

Capability StudyClaw Generic AI Bot
Privacy 100% Local Intelligence Cloud Logging
Group Context Proactive Monitoring Manual Copy-Paste
Memory Persistent Academic Profile Session-Only Context
Diagrams Native Circuit/Flowcharts Textual Description

Engineering Roadmap

Q2 2026

Voice Synthesis v2

AI-generated audio summaries for lecture halls with native text-to-speech injection.

Q3 2026

Collaborative RAG

Share your indexed notes across group study participants with decentralized indexing.

Q4 2026

Native iOS/Android Bridge

Dedicated Flutter-based administrative portal for managing personas and RAG storage.

Engineering Blog

Technical deep-dives into AI, exam patterns, and Android system engineering.

AI & Exams

How AI Predicts Exam Questions with 85% Accuracy

Deep dive into the StudyClaw PYQ engine and historical pattern analysis using Gemini AI.

Read Article
System Design

Running a Go-Based AI Bot on Android with Termux

Solving the architectural challenges of running non-native binaries on a mobile OS partition.

Read Article
Interface Design

Why WhatsApp is the World's Best Interface for Students

Analyzing the UX benefits of meeting students where they already spend 4+ hours a day.

Read Article

Common Errors & Patches

Documented solutions for the most frequent technical hurdles encountered by the community.

Critical Fix

Resolving "bash: go: command not found"

Encountered when the Go toolchain isn't mapped to the system path or missing from the initial Termux bootstrap.

Patch Action:

$ pkg install golang -y
Auth Error

Fixing "401 Unauthorized" Key Issues

Commonly caused by hidden characters in the export command or using a key that hasn't propagation through Google's AI Studio.

Patch Action:

$ export GEMINI_API_KEY="...KEY..."
Render Error

WhatsApp QR Code Scaling Issues

When the WhatsApp QR code appears broken or un-scannable due to Termux terminal buffer limitations.

Patch Action:

Pinch to zoom out in Termux until QR fills the screen.
Quota Error

Handling "429: Rate Limit Exceeded"

Triggered on Gemini Free Tier keys when sending too many messages too quickly. The bot may stop responding temporarily.

Patch Action:

Wait 1 minute for quota reset. Switch to Telegram for better stability.
Knowledge Base

Go Mod Tidy: Connection Refused

Network-level blocks prevent dependency downloads. Usually tied to DNS or local ISP restrictions in specific regions.

  • Toggle Wi-Fi / Airplane Mode
  • Disable Active VPNs

Need deep-level support? Open a Technical Ticket