git404hub

what is telepresence fr?

telepresenceio/telepresence — explained in plain English

Analysis updated 2026-06-24

7,208GoAudience · ops devopsComplexity · 4/5Setup · hard

tl;dr

Telepresence lets you run one service on your laptop while the rest of your app runs in a real Kubernetes cluster, so you can test code changes instantly without rebuilding or redeploying containers.

vibe map

mindmap
  root((telepresence))
    What it does
      Local to cluster proxy
      Skip container builds
      Instant code testing
    How it works
      Proxy shell session
      Traffic intercept
      Two-way networking
    Compatibility
      Kubernetes
      OpenShift
      Linux and macOS
    Audience
      Backend developers
      DevOps teams

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 make with this?

VIBE 1

Skip container rebuilds when iterating on a Kubernetes service by running it locally while all other cluster services stay live.

VIBE 2

Attach a local debugger to a service that depends on real Kubernetes cluster dependencies you cannot run on your laptop alone.

VIBE 3

Test code changes against a live Kubernetes environment instantly without pushing images or waiting for rolling deployments.

what's the stack?

GoKubernetes

how it stacks up fr

telepresenceio/telepresencedavecheney/httpstatcloudwego/hertz
Stars7,2087,2037,215
LanguageGoGoGo
Setup difficultyhardeasymoderate
Complexity4/51/53/5
Audienceops devopsdeveloperdeveloper

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

how do i run it?

Difficulty · hard time til it works · 1h+

Requires an active Kubernetes or OpenShift cluster. This repo is Telepresence 1, which is deprecated, try Telepresence 2 first.

License not stated in the explanation.

in plain english

Telepresence is a developer tool that solves a common problem when building applications on Kubernetes: testing your code changes requires building a container image, pushing it to a registry, and deploying it to the cluster, which can take minutes each time. Telepresence removes that cycle by letting you run one service on your own laptop while the rest of the application continues running in a real Kubernetes cluster in the cloud. The way it works is by creating a proxy between your local machine and the remote cluster. When you run Telepresence, it gives you a shell where your local process can talk to all the other services in the cluster as if it were deployed there, and the cluster can send traffic to your local process as if it were a pod running inside Kubernetes. You can attach a debugger, edit code and test immediately, and use all your usual local development tools without any container rebuilds. This repository is for Telepresence 1, which the README notes is being replaced by Telepresence 2. The README advises trying version 2 first. Telepresence is an open source project hosted by the Cloud Native Computing Foundation, the same organization that oversees Kubernetes itself. It was originally created by Ambassador Labs, which also offers a commercial team-oriented version. The tool supports Linux and macOS and can be installed via Homebrew, apt, or dnf. It works with both Kubernetes and OpenShift clusters. This tool is aimed at backend developers who work in environments where the full application is too large or dependent on cloud infrastructure to run locally, but who still want a fast feedback loop when writing and testing code.

prompts (copy fr)

prompt 1
Using Telepresence 1, swap my local user-service into a Kubernetes cluster so I can test it against live dependencies without rebuilding the Docker image.
prompt 2
How do I use Telepresence to attach a local Go debugger to a service running inside a Kubernetes cluster?
prompt 3
What are the differences between Telepresence 1 and Telepresence 2, and how do I migrate my local dev workflow to version 2?
prompt 4
Show me the Telepresence commands to intercept traffic for a specific Kubernetes deployment and redirect it to my local port 8080.
prompt 5
How do I use Telepresence with an OpenShift cluster instead of vanilla Kubernetes?

Frequently asked questions

what is telepresence fr?

Telepresence lets you run one service on your laptop while the rest of your app runs in a real Kubernetes cluster, so you can test code changes instantly without rebuilding or redeploying containers.

What language is telepresence written in?

Mainly Go. The stack also includes Go, Kubernetes.

What license does telepresence use?

License not stated in the explanation.

How hard is telepresence to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is telepresence for?

Mainly ops devops.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.