What you can do with Needle

3 use cases

• Control your phone by texting a Telegram bot

  Run a background Telegram listener so text commands like flashlight or battery status run on your phone.

  • Needle
  • Personal productivity
  • Intermediate
  View prompt

  Using the Needle repo at <repo path>, set up the Termux environment, then start the Telegram listener with python3 app.py --model 3 --telegram <bot token>. Send the bot the message "turn on the flashlight" and report the reply. Verify that the reply confirms the torch action and that /model returns the current model.

  Share Save

• Find contacts by meaning with a local semantic search

  Ask the Needle 3 model to search your contacts for a concept like doctor or emergency.

  • Needle
  • Personal productivity
  • Intermediate
  View prompt

  In the Needle repo, start python termux_needle.py --model 3 and send the prompt "semantically search contacts for doctor or emergency". Return the matched contacts as a list. Verify that each result actually matches the requested role before reporting it.

  Share Save

• Pull structured contact fields out of messy text

  Use Needle 3 structured extraction to turn a sentence into fields like name, phone, and email.

  • Needle
  • Personal productivity
  • Intermediate
  View prompt

  In the Needle repo, run python termux_needle.py --model 3 and submit "extract contact info from: <text>" with the target text. Expect structured contact fields with name, phone, and email. Verify that each field appears verbatim in the input text before using the result.

  Share Save

How to use Needle

1. Check you have what it needs: An Android phone with Termux and the Termux:API app installed; Python and git available in Termux, with the Ubuntu PRoot environment set up as the README describes; A Telegram bot token if you want remote control.
2. Open AbuZar-Ansarii/Needle on GitHub and read the README and license.
3. In Termux, run pkg update && pkg upgrade, then pkg install termux-api python git, pkg install proot-distro, proot-distro install ubuntu, and proot-distro login ubuntu.
4. Inside Ubuntu, run apt update && apt upgrade -y and apt install git python3 python3-pip python3-venv ca-certificates -y.
5. Run git clone https://github.com/AbuZar-Ansarii/Needle.git, then cd Needle, python3 -m venv myenv, source myenv/bin/activate, and pip3 install -r requirements.txt.
6. Start the listener with python3 app.py --model 3 --telegram YOUR_BOT_TOKEN, replacing YOUR_BOT_TOKEN with your token.

These steps come from our top use case, Control your phone by texting a Telegram bot, which also has a copy-paste agent prompt.

Needle alternatives · Best AI repos for Personal productivity

About this repo

• Who it is forAndroid users comfortable with Termux and a bit of Python who want to run a phone assistant locally and control it from a web page, the terminal, or Telegram.
• Why it is hot
• LanguagePython
• Sourcegithub.com/AbuZar-Ansarii/Needle · Back to Hot repos

Requirements

• An Android phone with Termux and the Termux:API app installed
• Python and git available in Termux, with the Ubuntu PRoot environment set up as the README describes
• A Telegram bot token if you want remote control

Related repos

• Trended earlier Graybox Gray Box is a local-first command-line tool that saves your notes as Markdown, organizes them into linked wiki pages with an LLM, and answers questions with cited sources.
• Trended earlier Pocket Strike PocketStrike is an open-source Flutter app that turns an Android phone into an AI workstation with on-device GGUF models, cloud LLM providers, a ReAct agent, MCP servers, memory files, and image generation.
• Trended earlier Lossless Memory A local, file-based long-term memory layer for a personal AI that keeps every conversation line verbatim, timestamps each record, and searches by time before words.