Guides
Guides
Task-based walkthroughs, from a first chat to writing your own provider.
Each guide is one task with a result you can check at the end. Start with your first session if you have never run elelem. The rest stand alone: run a model offline, write a tool or a provider, connect MCP servers and agent skills, script elelem from the shell, or measure models against each other. Every command and file path comes from the source of the gems involved, and each guide says which ones it uses.
- Your first session Install elelem with the default tools and Ollama, chat with a local model, and ask a one-shot question.
- Run elelem fully offline Run a GGUF model inside the elelem process with elelem-llama, with GPU offload and a context size you choose.
- Write a tool plugin Add a tool the model can call, in one Ruby file, then package it as a gem.
- Write a provider plugin Connect elelem to a new model API by implementing one method, fetch, that streams events back to the agent.
- Connect MCP servers Give the agent the tools of any MCP server, local over stdio or remote over HTTP with OAuth, using elelem-mcp.
- Use agent skills Write a SKILL.md file, let the model load it when it needs it, and install skills from a remote index.
- Use elelem in shell pipelines Pipe text into elelem ask, feed it files with elelem files, and use the reply in scripts and git workflows.
- Compare models with elelem-evals Run the same coding tasks against different providers and models, and write your own cases to test what matters to you.