codel  by semanser

Autonomous AI agent for complex tasks using terminal, browser, and editor

Created 1 year ago
2,385 stars

Top 19.3% on SourcePulse

GitHubView on GitHub
Project Summary

Codel is a self-hosted, autonomous AI agent designed to execute complex tasks and projects by interacting with the terminal, browser, and a built-in text editor. It targets developers and power users seeking an automated solution for project execution, offering a secure, sandboxed Docker environment and a modern UI.

How It Works

Codel operates autonomously, detecting and executing the next logical step for a given task. It leverages a built-in browser for fetching real-time information and a text editor for file management, all within a Dockerized environment. Task history and commands are persisted in a PostgreSQL database, and the system automatically selects appropriate Docker images based on the task requirements.

Quick Start & Requirements

  • Install/Run: docker run -e OPEN_AI_KEY=your_open_ai_key -e OPEN_AI_MODEL=gpt-4-0125-preview -e OLLAMA_MODEL=llama2 -p 3000:8080 -v /var/run/docker.sock:/var/run/docker.sock ghcr.io/semanser/codel:latest
  • Prerequisites: OpenAI API key or a locally hosted Ollama model.
  • Resource Footprint: Requires Docker and sufficient resources for running LLMs and the agent.
  • Links: Discord, Roadmap

Highlighted Details

  • Secure, sandboxed Docker environment.
  • Built-in browser for web information retrieval.
  • Integrated text editor for file viewing and modification.
  • Automatic Docker image selection based on task.
  • PostgreSQL for command history and output persistence.

Maintenance & Community

The project has a Discord server for community interaction. Key inspirations include research papers on autonomous agents and projects like Devin.

Licensing & Compatibility

The repository's license is not explicitly stated in the README. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

Codel requires specific environment variables for LLM integration (OpenAI or Ollama). The README does not detail specific hardware requirements beyond Docker, nor does it mention any known limitations or alpha/beta status.

Health Check
Last Commit

1 year ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
7 stars in the last 30 days

Explore Similar Projects

Starred by Edward Z. Yang Edward Z. Yang(Research Engineer at Meta; Maintainer of PyTorch), Anton Osika Anton Osika(Cofounder of Lovable), and
3 more.

gptme by gptme

0.3%
4k
CLI tool for terminal agent workflows
Created 2 years ago
Updated 20 hours ago
Starred by Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), Luis Capelo Luis Capelo(Cofounder of Lightning AI), and
15 more.

stagehand by browserbase

0.5%
17k
AI browser automation framework for production
Created 1 year ago
Updated 1 day ago
Starred by Paul Stamatiou Paul Stamatiou(Cofounder of Limitless), Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), and
5 more.

claude-task-master by eyaltoledano

1.0%
22k
AI-powered task management system for code editors
Created 6 months ago
Updated 23 hours ago
Feedback? Help us improve.