{"id":47183004,"url":"https://github.com/elroy-bot/elroy","last_synced_at":"2026-03-27T13:01:05.573Z","repository":{"id":262340134,"uuid":"884920346","full_name":"elroy-bot/elroy","owner":"elroy-bot","description":"An AI assistant that remembers and sets goals","archived":false,"fork":false,"pushed_at":"2026-03-20T18:23:00.000Z","size":57899,"stargazers_count":53,"open_issues_count":13,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-21T07:53:16.282Z","etag":null,"topics":["ai","memory","memory-management"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/elroy-bot.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-11-07T16:14:25.000Z","updated_at":"2026-03-20T16:15:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"94bb650c-fb5a-44b6-ab94-0d8cf35ecd24","html_url":"https://github.com/elroy-bot/elroy","commit_stats":null,"previous_names":["elroy-bot/elroy"],"tags_count":77,"template":false,"template_full_name":null,"purl":"pkg:github/elroy-bot/elroy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elroy-bot%2Felroy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elroy-bot%2Felroy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elroy-bot%2Felroy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elroy-bot%2Felroy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elroy-bot","download_url":"https://codeload.github.com/elroy-bot/elroy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elroy-bot%2Felroy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31045640,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-27T09:35:52.079Z","status":"ssl_error","status_checked_at":"2026-03-27T09:35:20.916Z","response_time":164,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","memory","memory-management"],"created_at":"2026-03-13T08:00:38.368Z","updated_at":"2026-03-27T13:01:05.560Z","avatar_url":"https://github.com/elroy-bot.png","language":"Python","funding_links":[],"categories":["\u003ca name=\"ai\"\u003e\u003c/a\u003eAI / ChatGPT"],"sub_categories":[],"readme":"# Elroy\n\n[![Discord](https://img.shields.io/discord/1200684659277832293?color=7289DA\u0026label=Discord\u0026logo=discord\u0026logoColor=white)](https://discord.gg/5PJUY4eMce)\n[![Documentation](https://img.shields.io/badge/docs-elroy.bot-C8C7E8)](https://elroy.bot)\n[![PyPI](https://img.shields.io/pypi/v/elroy)](https://pypi.org/project/elroy/)\n\nElroy is a scriptable, memory augmented AI personal assistant, accessible from the command line. It features:\n\n- **Long-term Memory**: Automatic memory recall of past conversations\n- **Reminders** Track context based and timing based reminders\n- **Simple scripting interface**: Script Elroy with minimal configuration overhead\n- **CLI Tool interface**: Quickly review memories Elroy creates for you, or jot quick notes for Elroy to remember.\n\n![Reminder demo](./docs/images/reminders_demo.gif)\n\n\n## Quickstart\n\nThe fastest way to get started is using the install script:\n\n```bash\ncurl -LsSf https://raw.githubusercontent.com/elroy-bot/elroy/main/scripts/install.sh | sh\n```\n\nOr install manually with UV:\n\n```bash\n# Install UV first\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Then install Elroy\nuv pip install elroy\n```\n\nFor detailed installation instructions including Docker and source installation options, see the [Installation Guide](docs/installation.md).\n\n## Basic Usage\n\nOnce installed, run `elroy` to open the interactive chat interface:\n\n```bash\nelroy\n```\n\nElroy opens a terminal UI where you can chat, create memories, and manage reminders. Use `/help` inside the chat to see available slash commands.\n\n## Memory and Reminder Tools\n![Slash commands](images/slash_commands.gif)\n\nElroy's tools allow it to create and manage memories and reminders. In the background, redundant memories are consolidated.\n\nAs reminders or memories become relevant to the conversation, they are recalled into context. A `Relevant Context` panel makes all information being surfaced to the assistant available to the user.\n\nAll commands available to the assistant are also available to the user via `/` slash commands in the chat interface.\n\nFor a guide of what tools are available and what they do, see: [tools guide](docs/tools_guide.md).\n\nFor a full reference of tools and their schemas, see: [tools schema reference](docs/tools_schema.md)\n\n\n### Configuration\nElroy is designed to be highly customizable, including appearance and memory consolidation parameters.\n\nConfiguration can be provided via environment variables (e.g. `ELROY_CHAT_MODEL=gpt-5`) or a config file at `~/.elroy/elroy.conf.yaml`.\n\nFor full configuration options, see [configuration documentation](docs/configuration/index.md).\n\n\n### Supported Models\n\nElroy supports OpenAI, Anthropic, Google (Gemini), and any OpenAI-compatible API.\n\nThe model is selected automatically based on which API key is set, or can be configured explicitly:\n\n```bash\n# Use an Anthropic model\nELROY_CHAT_MODEL=claude-sonnet-4-5-20250929 elroy\n\n# Use a specific OpenAI model\nELROY_CHAT_MODEL=gpt-5 elroy\n\n# Use Gemini\nELROY_CHAT_MODEL=gemini/gemini-2.0-flash elroy\n```\n\nCommon model aliases can be used as the `chat_model` config value:\n- `sonnet`: Anthropic's Claude 4.5 Sonnet\n- `opus`: Anthropic's Claude 4.5 Opus\n- `haiku`: Anthropic's Claude 3.5 Haiku\n- `o1`: OpenAI's o1 model\n\n## Claude Code Integration\n\nElroy provides skills for [Claude Code](https://github.com/anthropics/claude-code) that expose memory management as slash commands:\n\n- `/remember` - Create a long-term memory\n- `/recall` - Search through memories\n- `/list-memories` - List all memories\n- `/remind` - Create a reminder\n- `/list-reminders` - List active reminders\n- `/ingest` - Ingest documents into memory\n\n### Installation\n\nInstall the Claude Code skills using the Elroy CLI:\n\n```bash\nelroy install-skills\n```\n\nOr use the just command from the repository:\n\n```bash\njust install-claude-skills\n```\n\nThis installs skills to `~/.claude/skills/` making them available in all Claude Code sessions.\n\n**Important**: Restart your Claude Code session after installation to load the new skills.\n\nTo uninstall:\n\n```bash\nelroy install-skills --uninstall\n```\n\nFor detailed usage and examples, see [claude-skills/README.md](claude-skills/README.md).\n\n## Branches\n\n`main` comes with backwards compatibility and automatic database migrations.\n\n`stable` is sync'd with the latest release branch.\n\n`experimental` is a test branch with upcoming changes. These may contain breaking changes and/or changes that do not come with automatic database migrations.\n\n## License\n\nDistributed under the Apache 2.0 license. See LICENSE for more information.\n\n## Contact\n\nBug reports and feature requests are welcome via [GitHub](https://github.com/elroy-bot/elroy/issues)\n\nGet in touch on [Discord](https://discord.gg/5PJUY4eMce) or via [email](hello@elroy.bot)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felroy-bot%2Felroy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felroy-bot%2Felroy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felroy-bot%2Felroy/lists"}