explaingit

thatsme/alexclaw

Analysis updated 2026-05-18

114ElixirAudience · developerComplexity · 4/5Setup · hard

TLDR

A self hosted, single user AI agent built on Elixir that monitors feeds and APIs, runs automated workflows, and reasons through multi step goals.

Mindmap

mindmap
  root((AlexClaw))
    What it does
      Monitors feeds and APIs
      Runs workflows
      Reasoning loop
    Tech stack
      Elixir OTP
      PostgreSQL
      Telegram Discord
    Use cases
      Personal automation
      Model cost routing
      Autonomous goals
    Audience
      Developers
      Self hosters

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

Monitor RSS feeds, websites, and GitHub repos, then get relevance scored summaries on Telegram.

USE CASE 2

Build multi step automation workflows with conditional branching and automatic retries.

USE CASE 3

Route each task to the cheapest capable AI model, including fully local models.

USE CASE 4

Let the agent plan and execute multi step goals autonomously, asking for input when stuck.

What is it built with?

ElixirOTPPostgreSQLpgvector

How does it compare?

thatsme/alexclawcarterperez-dev/exs-cyberjob-scraperelixir-vibe/vibe_kit
Stars1142116
LanguageElixirElixirElixir
Setup difficultyhardeasyeasy
Complexity4/52/52/5
Audiencedevelopergeneraldeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires your own infrastructure including a PostgreSQL database with vector search support.

In plain English

AlexClaw is a self hosted personal AI agent built on Elixir and OTP, a programming platform known for building highly reliable, concurrent systems. It runs entirely on your own hardware, so your data stays private, and it is designed for a single user, meaning you, rather than as a shared platform or service. The agent watches the world on your behalf across RSS feeds, websites, GitHub repositories, and other APIs. It gathers this information into a searchable knowledge base and runs scheduled workflows automatically without you needing to trigger them manually. You communicate with it through Telegram or Discord. One notable feature is its multi model routing system. Rather than always calling the same AI model for every task, AlexClaw classifies each task by complexity, light, medium, heavy, or local, and picks the cheapest model capable of handling it, including fully local models that run on your own machine with no internet connection required. Workflows are multi step pipelines you define to automate recurring tasks, for example fetching an RSS feed, scoring the items for relevance with an AI call, then sending a summary to Telegram. The system supports conditional branching between steps, retry logic, and circuit breakers, which automatically disable a step that keeps failing and turn it back on after a cooldown period. The agent also offers a reasoning mode where it plans and carries out multi step goals on its own, checks its own results against a rubric, and asks you for input when it gets stuck. Memory is stored in a PostgreSQL database with vector search for retrieving relevant context by meaning rather than exact keywords. An MCP server, a standardized protocol for AI tool integration, lets external tools such as Claude Code connect to AlexClaw's capabilities directly. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me set up AlexClaw to monitor a GitHub repo and notify me on Telegram of important changes.
Prompt 2
Explain how AlexClaw's multi model routing decides which AI model to use for a task.
Prompt 3
Design a workflow in AlexClaw that fetches an RSS feed, scores items, and sends a Telegram summary.
Prompt 4
Walk me through connecting AlexClaw to Claude Code via its MCP server.

Frequently asked questions

What is alexclaw?

A self hosted, single user AI agent built on Elixir that monitors feeds and APIs, runs automated workflows, and reasons through multi step goals.

What language is alexclaw written in?

Mainly Elixir. The stack also includes Elixir, OTP, PostgreSQL.

How hard is alexclaw to set up?

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

Who is alexclaw for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.