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.

bolt Initialize Instance
$ git clone https://github.com/roshan30-git/picoclaw-scholar.git content_copy
check_circle Open Source lock E2E Encrypted speed <50ms Latency
user@studyclaw: ~/picoclaw-scholar
settings
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

psychology
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.

route
CORE

Smart Message Routing

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

travel_explore

Real-time Web Search

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

picture_as_pdf

PDF & Image Ingestion

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

quiz

Adaptive Quizzes

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

table_view

Excel Export

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

account_tree

Diagrams & Circuits

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

memory
NEW

Dynamic Student Memory

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

calendar_today

Proactive Reminders

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

lock

Passive Group Privacy

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

send
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
rocket_launch

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!

check_circle 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
check_circle 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.

psychology 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 arrow_forward
terminal 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 arrow_forward
chat 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 arrow_forward

Common Errors & Patches

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

bug_report 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
key 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..."
aspect_ratio 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.
hourglass_empty 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