whatisgithub

What is qwen-code?

jdresdev/qwen-code — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A local, offline coding assistant CLI powered by Qwen2.5-Coder via Ollama, with agentic tool use, a terminal REPL, and Qdrant-based code search.

Mindmap

mindmap
  root((qwen-code))
    What it does
      Local Coding Assistant
      Terminal REPL
      Agentic Tool Use
    Tech stack
      Python
      Qwen2.5-Coder
      Ollama
      Qdrant
    Features
      RAG Retrieval
      Permission System
      One-shot Mode
    Audience
      Developers
      Privacy-focused Users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a Claude Code-style AI coding assistant fully offline with no API key and no code leaving your machine.

USE CASE 2

Ask an agent to read files, run shell commands, and search your codebase from an interactive terminal REPL.

USE CASE 3

Index your own project or documents into a local vector database so the assistant can answer questions using retrieval-augmented generation.

USE CASE 4

Require explicit confirmation before the assistant runs any command that writes, edits, or deletes files.

What is it built with?

PythonQwen2.5-CoderOllamaQdrant

How does it compare?

jdresdev/qwen-code0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity3/54/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Ollama with two pulled models and a running Qdrant instance (Docker, local file, or in-memory) before first use.

So what is it?

qwen-code is a command-line coding assistant that runs entirely on your own machine, with no cloud API required. You interact with it through a terminal, either in an interactive back-and-forth session or by passing a one-off question as a command. It is described as a Claude Code-style tool, meaning it can reason through a task by repeatedly using tools to read files, run shell commands, search your codebase, and look things up before giving you a final answer. The AI model behind it is Qwen2.5-Coder, which runs locally via Ollama, a tool for running large language models on your own hardware. This means your code never leaves your machine. You can switch between different model sizes mid-session, change the working directory, or reset the conversation using slash commands inside the REPL. One of its notable features is RAG, which stands for retrieval-augmented generation. This lets you feed your own documents or code into a vector database called Qdrant, then have the assistant search that database when answering questions. It uses a separate embedding model called nomic-embed-text, also run through Ollama, to convert text into a searchable format. Qdrant can be run as a local server, a local file, or entirely in memory depending on your preference. The tool includes a permission system so that read-only operations like reading files or searching happen automatically, while anything that could change or delete files requires you to confirm with a yes or no prompt before it runs. The project is written in Python.

Copy-paste prompts

Prompt 1
Help me install qwen-code, pull the qwen2.5-coder and nomic-embed-text models with Ollama, and start the interactive REPL.
Prompt 2
Show me how to configure qwen-code's RAG pipeline to ingest my project's docs folder into Qdrant.
Prompt 3
Explain how qwen-code's permission system decides which tool calls need a y/N confirmation before running.
Prompt 4
Walk me through adding a new tool to qwen-code by editing tools/registry.py and tools/executor.py.
Prompt 5
How do I switch qwen-code to a larger Qwen2.5-Coder model mid-session using the /model command?

Frequently asked questions

What is qwen-code?

A local, offline coding assistant CLI powered by Qwen2.5-Coder via Ollama, with agentic tool use, a terminal REPL, and Qdrant-based code search.

What language is qwen-code written in?

Mainly Python. The stack also includes Python, Qwen2.5-Coder, Ollama.

How hard is qwen-code to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is qwen-code for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.