PicoCode - Local Codebase Assistant

Are you looking for a simple way to asks question to your codebase using the inference provider you want without to be locked to a specific service? This tool is a way to achieve this!

Overview

• Indexes files, computes embeddings using an OpenAI-compatible embedding endpoint, stores data in SQLite (with SQlite-vector).
• Reads dependencies by running python -m pip list --format=json inside a virtualenv when available.
• Detects Astral "uv" usage (https://docs.astral.sh/uv/) by inspecting pyproject.toml and/or installed packages in a venv; if uv is detected it tries to locate a venv managed by uv and uses it for pip list.
• Analysis runs asynchronously (FastAPI BackgroundTasks) so the UI remains responsive.
• Minimal web UI for starting analysis and asking questions (semantic search + coding model).

Prerequisites

• Python 3.8+ (3.11+ recommended for builtin tomllib)
• Git (optional, if you clone the repo)
• If you use Astral uv, install/configure uv according to the official docs: https://docs.astral.sh/uv/

Installation and run commands

First step: Example .env (copy .env.example -> .env and edit)

Astral uv

• Follow Astral uv installation instructions first: https://docs.astral.sh/uv/
• Typical flow (after uv is installed and you are in the project directory):

  uv pip install -r pyproject.toml

  uv run python ./main.py

Notes:

• The exact uv subcommands depend on the uv version/configuration. Check the Astral uv docs for the exact syntax for your uv CLI release. The analyzer only needs a Python executable in the venv to run python -m pip list --format=json; uv typically provides or creates that venv.

Using plain virtualenv / pip (fallback)

• Create a virtual environment and install dependencies listed in pyproject.toml with your preferred tool.

  # create venv
  python -m venv .venv

  # activate (UNIX)
  source .venv/bin/activate

  # activate (Windows PowerShell)
  .venv\Scripts\Activate.ps1

  uv pip install -r pyproject.toml

  # run the server
  python ./main.py

Using Poetry

  poetry install
  poetry run main.py