{"id":34970722,"url":"https://github.com/benbaptist/luminos","last_synced_at":"2026-04-24T15:31:50.557Z","repository":{"id":228097280,"uuid":"773147149","full_name":"benbaptist/luminos","owner":"benbaptist","description":"A CLI utility integrating Large Language Models (LLMs) into your shell, empowering seamless interaction with advanced AI directly in the terminal. 🚀","archived":false,"fork":false,"pushed_at":"2024-07-30T16:34:12.000Z","size":218,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-07-31T07:00:55.399Z","etag":null,"topics":["ai","ai-led","cli","http","llm","programming","shell"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/benbaptist.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-16T21:53:46.000Z","updated_at":"2024-06-21T05:48:14.000Z","dependencies_parsed_at":"2024-04-21T23:28:28.281Z","dependency_job_id":"cedf8ba9-3d21-46e0-a859-1127dc3c19ed","html_url":"https://github.com/benbaptist/luminos","commit_stats":null,"previous_names":["benbaptist/luminos"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/benbaptist/luminos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benbaptist%2Fluminos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benbaptist%2Fluminos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benbaptist%2Fluminos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benbaptist%2Fluminos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/benbaptist","download_url":"https://codeload.github.com/benbaptist/luminos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benbaptist%2Fluminos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32228955,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T13:21:15.438Z","status":"ssl_error","status_checked_at":"2026-04-24T13:21:15.005Z","response_time":64,"last_error":"SSL_read: 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","ai-led","cli","http","llm","programming","shell"],"created_at":"2025-12-26T23:44:51.774Z","updated_at":"2026-04-24T15:31:50.552Z","avatar_url":"https://github.com/benbaptist.png","language":"Python","readme":"# Luminos - Large Language Models in the Shell\n\n## Overview\n\nLuminos is a command line utility that integrates Large Language Models (LLMs) into your local shell environment. It provides system access through a variety of tools to an LLM of choice, allowing you to perform various tasks with natural language. \n\nThis program provides the LLM with tools enabling full system access, network access, and shell access. Any potentially dangerous tools, such as writing files or shell access, is behind a permission prompt for the user.\n\n## Features\n\n- **Natural Language Interface**: Perform various tasks using natural language commands\n- **LLM Integration**: Compatible with multiple Large Language Models\n- **System Access**: Provides LLMs tools for:\n  - Full filesystem access\n  - Network access\n  - Shell access\n- **Safety Measures**:\n  - Permission prompts for potentially dangerous actions\n  - Detailed previews of actions before execution\n- **Versatile Tool Integration**: Enhances LLM capabilities with various system tools\n\n## Example Uses\n\n- **File Management**: \"Find all PDF files created last month and move them to a new folder.\"\n- **Data Analysis**: \"Analyze the CSV file in my Downloads folder and generate a summary report.\"\n- **System Maintenance**: \"Check for and install system updates, then reboot if necessary.\"\n- **Code Assistance**: \"Find all TODO comments in my Python project and create a task list.\"\n- **Network Diagnostics**: \"Run a network speed test and log the results.\"\n- **Text Processing**: \"Extract all email addresses from the given text file and save them to a new file.\"\n- **Automation**: \"Create a bash script that backs up my Documents folder daily.\"\n\n## Installation\nTo install Luminos from the Git repository, use the following commands:\n\n```\npip3 install wheel\npip3 install git+https://github.com/benbaptist/luminos\n```\n\n## Getting Started\n\nOnce installed, run `luminos` once to create your configuration in `~/.config/luminos`. Edit the configuration to specify your default LLM and, if applicable, API keys. Run `luminos` again to try it out.\n\nLuminos currently supports OpenAI and Anthropic, with support for more providers (including Ollama) coming soon. \n\nFor working within a specific directory, provide the path like so:\n\n```\nluminos path_to_dir\n```\n\nUpon starting Luminos, an interactive session is initiated, allowing the LLM to interact with the directory specified. Utilize the LLM's capabilities to manage tasks, ask questions, or perform actions within the shell environment.\n\n## Examples\n\nExplore a few examples of how Luminos can enhance your daily tasks:\n\n- **File Management:** Instruct the LLM to rename, move, or modify files based on specific criteria.\n- **Software Development:** Start Luminos within a project's directory, and ask it to make code revisions. Most of Luminos itself was written this way.\n- **Data Analysis:** Leverage the LLM for data analysis, sorting, and summarization tasks.\n- **Terminal Operations:** Get assistance and guidance from the LLM for executing commands and complex operations in the shell.\n\n## Project Background\n\nLuminos is an AI-driven project that showcases the capabilities of AI-generated content. The tool itself was utilized to develop most of the content within this project. This demonstrates the potential of AI-driven development and the seamless integration of AI-generated content to suit user needs.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenbaptist%2Fluminos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenbaptist%2Fluminos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenbaptist%2Fluminos/lists"}