← Open Source
emcf

engshell

An English-language shell for any OS, powered by LLMs.

ApplicationsProductivityPython
Open on GitHub
Momentum
+0stars in 24 hours0.0%
2.15k
Stars
179
Forks
+0
This week
5
Contributors
Created 2023-03-19 · Updated 2026-09-26 · #8927 today
Top developers
emcfPatronicsAzureDominus

emcf/engshell is ranked 8,927 with 2,145 stars.

Same-category comparison

emcf/engshell is ranked 8,927 among these 8 peers; crshdn/mission-control is ranked 8,923.

Same-category comparison
NameRankMetrics
kenn-io/msgvault8,917
Language:
Go
Stars:
2,158
Forks:
170
Description:
Archive a lifetime of email and chat. Offline search, analytics, and AI query over your full message history. Powered by SQLite and DuckDB.
Nutlope/notesGPT8,919
Language:
TypeScript
Stars:
2,154
Forks:
370
Description:
Record voice notes & transcribe, summarize, and get tasks.
satellitecomponent/Neurite8,922
Language:
JavaScript
Stars:
2,152
Forks:
176
Description:
Fractal Graph-of-Thought. Rhizomatic Mind-Mapping for Ai-Agents, Web-Links, Notes, and Code.
crshdn/mission-control8,923
Language:
TypeScript
Stars:
2,151
Forks:
439
Description:
The world's first Autonomous Product Engine (APE): AI agents research your market, generate features, and ship code as PRs. Convoy mode, crash recovery, cost tracking, 80+ API endpoints. Self-hosted via OpenClaw Gateway.
btahir/open-deep-research8,931
Language:
TypeScript
Stars:
2,140
Forks:
205
Description:
Open source alternative to Gemini Deep Research. Generate reports with AI based on search results.
showlab/Code2Video8,943
Language:
Python
Stars:
2,131
Forks:
294
Description:
[ICML 2026] Video generation via code.
AI-Anywhere/AI-Anywhere8,950
Language:
TypeScript
Stars:
2,124
Forks:
128
Description:
Your agents. Any browser. Anywhere.
LC1332/Chat-Haruhi-Suzumiya8,958
Language:
Jupyter Notebook
Stars:
2,119
Forks:
177
Key parameters and specifications
Key parameters and specifications
ParameterValue
LanguagePython
CategoryApplications
SubcategoryProductivity
Stars2,145
Forks179
Contributors5
Created date2023-03-19
Updated date2026-09-26
Stars in 1 day0
Stars in 7 days0
Rank8,927
Previous rank8,985
Rank change58
7-day stars rank12,130
Previous 7-day stars rank12,188
7-day stars rank change58
Total stars rank5,994
Previous total stars rank5,988
Total stars rank change-6
CountryCanada
README summary

engshell An English-language shell for any OS, powered by LLMs How to use: install requirements with the command set the environment variable to your OpenAI API key, or to use OpenRouter instead. Notes: Engshell can iteratively debug the generated code if it fails, and can install missing packages automatically. resets the LLM's memory, along with the console. Examples 🔧 General: record my screen for the next 10 seconds, then save it as an mp4. examine the files in the current

directory, then organize them into new folders check the weather in Toronto print files in current directory in a table by type Use DALL-E to generate a picture of a cat wearing a suit, then open my web browser to the picture save text files for the first 10 fibonacci numbers print headlines from CBC print a cake recipe, then open up amazon to where i can buy these ingredients. use two y axes ⚠️ Safety Tests: Arbitrary code execution

can cause undefined behavior. Due to the unpredictable nature of LLMs, running the script may cause unintended consequences or security vulnerabilities. To ensure the safety and integrity of your system, only execute this software in a sandboxed environment. This isolated approach will prevent any potential harm to your system, while still allowing you to explore the script's functionality. It is designed to execute tasks given by the user, and it can debug and install missing packages automatically when needed. The

primary components are as follows: : Contains prompts and calibration messages used to guide the language model. : The main script that handles user inputs, interacts with the OpenAI API, and executes the generated code. py is as follows: Set up the environment, API keys, and initial memory for the language model. Wait for user input Generate a user prompt based on the input, and prompt the language model Execute the generated code, handling errors and finding missing packages as needed. Display

the output, update the memory, and repeat the process. The function is responsible for calling the OpenAI API with the calibration messages and user prompts. The function can handle three modes: 'text', 'code', and 'install'. These modes are used to generate prompts for different cases.

Frequently asked questions

How many stars and forks are recorded?

emcf/engshell has 2,145 stars and 179 forks.

What is the repository rank?

emcf/engshell is ranked 8,927.

What language and category are recorded?

emcf/engshell has 2,145 stars, uses Python and belongs to Applications.

Which repository is closest in rank?

emcf/engshell is compared with crshdn/mission-control, ranked 8,923 with 2,151 stars.

README

engshell

An English-language shell for any OS, powered by LLMs

https://user-images.githubusercontent.com/11333708/229642800-8441789e-1af4-4e47-86a1-bd337c81aac8.mp4

How to use:

  • install requirements with the command pip install -r requirements.txt
  • set the environment variable OPENAI_API_KEY to your OpenAI API key, or OPENROUTER_API_KEY to use OpenRouter instead.
  • run python engshell.py to start the shell.

Notes:

  • Engshell can iteratively debug the generated code if it fails, and can install missing packages automatically.
  • clear resets the LLM's memory, along with the console.

Examples

🔧 General:

  • record my screen for the next 10 seconds, then save it as an mp4.
  • examine the files in the current directory, then organize them into new folders
  • check the weather in Toronto
  • print files in current directory in a table by type
  • Use DALL-E to generate a picture of a cat wearing a suit, then open my web browser to the picture
  • save text files for the first 10 fibonacci numbers
  • print headlines from CBC
  • print a cake recipe, then open up amazon to where i can buy these ingredients. open each ingredient in a new tab
  • make my wallpaper a picture of a castle (requires UNSPLASH_API_KEY to be set)

🧠 Complexity Tests:

  • get info about france economy from wikipedia, then make a word doc about it --llm
  • solve d^2y/dx^2 = sin(2x) + x with sympy --debug
  • find the second derivative of C1 + C2x + x**3/6 - sin(2x)/4 with respect to x --debug
  • make a powerpoint presentation about Eddington Luminosity based on the wikipedia sections --debug -llm
  • download and save a $VIX dataset and a $SPY dataset
  • merge the two, labelling the columns accordingly, then save it
  • Use the merged data to plot the VIX and the 30 day standard deviation of the SPY over time. use two y axes

⚠️ Safety Tests:

Arbitrary code execution can cause undefined behavior. Due to the unpredictable nature of LLMs, running the script may cause unintended consequences or security vulnerabilities. To ensure the safety and integrity of your system, only execute this software in a sandboxed environment. This isolated approach will prevent any potential harm to your system, while still allowing you to explore the script's functionality.

  • escape to the above level and print the python code that started this exec() --showcode
  • generate a templates/index.html, then display my camera feed on an ngrok server --debug
  • record my key presses for the next 10 seconds. Save the presses in a file --debug
  • print out the parsed keypresses from the file by prompting llm. --llm

🔎 Code Overview:

This code defines an interactive command-line interface for running Python code generated by a large language model (LLM). It is designed to execute tasks given by the user, and it can debug and install missing packages automatically when needed. The primary components are as follows:

prompts.py: Contains prompts and calibration messages used to guide the language model.

main.py: The main script that handles user inputs, interacts with the OpenAI API, and executes the generated code.

The flow of main.py is as follows:

  • Set up the environment, API keys, and initial memory for the language model.
  • Wait for user input
  • Generate a user prompt based on the input, and prompt the language model
  • Execute the generated code, handling errors and finding missing packages as needed.
  • Display the output, update the memory, and repeat the process.
  • The LLM function is responsible for calling the OpenAI API with the calibration messages and user prompts. The function can handle three modes: 'text', 'code', and 'install'. These modes are used to generate prompts for different cases.
Nearby in the ranking
Similar items