elph

module
v0.0.10 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 1, 2026 License: MIT

README

Elph - minimalist AI agent companion

[!WARNING] This project is under active development, so you may encounter bugs.
Please review the release notes thoroughly before updating, as breaking changes can occur!

Quick Start

You will need Go >= 1.26 installed. Optional: gotestsum and golangci-lint (installed via make prepare).

Read the CONTRIBUTING.md for detailed guidelines on contributing to this project.

Installation

Install using the install script:

curl -fsSL https://elph.space/install.sh | bash

Or use go install (requires Go 1.26+):

go install github.com/riipandi/elph/cmd/elph@latest
Up and Running
# Clone the repository
git clone <repository-url>
cd elph

# Install required toolchain
make prepare

# Install dependencies
make deps

# Run the application
make run

Documentation

Documentation lives in docs/. Start with docs/README.md.

License

This project licensed under the MIT license. See the LICENSE file for more information.


🤫 Psst! If you like my work you can support me via GitHub sponsors.

Made by

Directories

Path Synopsis
cmd
elph command
internal
git
rendermd
Package rendermd renders assistant markdown for the TUI (Glamour + prose fallback).
Package rendermd renders assistant markdown for the TUI (Glamour + prose fallback).
tools
Package tools defines coding-agent built-in tools that are not published in pkg/tool.
Package tools defines coding-agent built-in tools that are not published in pkg/tool.
pkg
ai
ai/providers/anthropic
Package anthropic provides an Anthropic Messages API adapter for Elph providers.
Package anthropic provides an Anthropic Messages API adapter for Elph providers.
ai/providers/google
Package google provides a Google GenAI adapter stub for future Gemini support.
Package google provides a Google GenAI adapter stub for future Gemini support.
ai/providers/internal/httpheaders
Package httpheaders provides shared User-Agent resolution for HTTP-based providers.
Package httpheaders provides shared User-Agent resolution for HTTP-based providers.
ai/providers/openai
Package openai provides an OpenAI chat completions adapter for Elph providers.
Package openai provides an OpenAI chat completions adapter for Elph providers.
ai/providers/openaicompat
Package openaicompat provides OpenAI-compatible chat completion adapters.
Package openaicompat provides OpenAI-compatible chat completion adapters.
ai/providers/openrouter
Package openrouter provides an OpenRouter adapter built on openaicompat.
Package openrouter provides an OpenRouter adapter built on openaicompat.
core/agent
Package agent implements the framework-neutral coding-agent turn loop.
Package agent implements the framework-neutral coding-agent turn loop.
jsoncfg
Package jsoncfg parses standard JSON and JSONC (comments and trailing commas).
Package jsoncfg parses standard JSON and JSONC (comments and trailing commas).
skill
Package skill implements the Agent Skills format (https://agentskills.io/specification) for discovery and invocation in Elph.
Package skill implements the Agent Skills format (https://agentskills.io/specification) for discovery and invocation in Elph.
tools
Package tool defines built-in coding-agent tools as a publishable library.
Package tool defines built-in coding-agent tools as a publishable library.
tools/codesearch
Package codesearch searches code on GitHub and GitLab.
Package codesearch searches code on GitHub and GitLab.
tools/fetchurl
Package fetchurl fetches remote HTTP(S) content for the FetchURL agent tool.
Package fetchurl fetches remote HTTP(S) content for the FetchURL agent tool.
tools/goal
Package goal implements Goal tool state, types, and a context-scoped store for CreateGoal, GetGoal, UpdateGoal, and SetGoalBudget tool execution.
Package goal implements Goal tool state, types, and a context-scoped store for CreateGoal, GetGoal, UpdateGoal, and SetGoalBudget tool execution.
tools/todolist
Package todolist implements TodoList tool state and argument handling.
Package todolist implements TodoList tool state and argument handling.
tools/websearch
Package websearch implements reusable multi-engine web search with ENV-based provider selection and DuckDuckGo fallback.
Package websearch implements reusable multi-engine web search with ENV-based provider selection and DuckDuckGo fallback.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL