{"id":23044436,"url":"https://github.com/lyulumos/terminal-agent-x","last_synced_at":"2025-10-27T10:02:43.432Z","repository":{"id":163922707,"uuid":"637700365","full_name":"LyuLumos/Terminal-Agent-X","owner":"LyuLumos","description":"A terminal agent powered by OpenAI/Claude/Gemini API","archived":false,"fork":false,"pushed_at":"2024-09-20T16:30:49.000Z","size":69,"stargazers_count":15,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-15T21:13:17.245Z","etag":null,"topics":["chatgpt","claude-api","dall-e","gemini","gpt-4o","gpt-4o-mini","o1-mini","o1-preview","terminal","vision"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/terminal-agent-x/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LyuLumos.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":"2023-05-08T08:22:17.000Z","updated_at":"2024-09-20T16:26:34.000Z","dependencies_parsed_at":"2024-07-31T07:55:35.212Z","dependency_job_id":"d1876e87-03a2-45a9-80e6-f00890c22232","html_url":"https://github.com/LyuLumos/Terminal-Agent-X","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LyuLumos%2FTerminal-Agent-X","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LyuLumos%2FTerminal-Agent-X/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LyuLumos%2FTerminal-Agent-X/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LyuLumos%2FTerminal-Agent-X/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LyuLumos","download_url":"https://codeload.github.com/LyuLumos/Terminal-Agent-X/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229875380,"owners_count":18137800,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["chatgpt","claude-api","dall-e","gemini","gpt-4o","gpt-4o-mini","o1-mini","o1-preview","terminal","vision"],"created_at":"2024-12-15T21:13:21.257Z","updated_at":"2025-10-27T10:02:38.375Z","avatar_url":"https://github.com/LyuLumos.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Terminal-Agent-X\n\n[EN](README.md) / [中文](https://github.com/LyuLumos/Terminal-Agent-X/blob/main/README_cn.md) \n\n## Features\n\n- 👻 Easy installation and usage with a single command.\n- 🎈 Small size, no additional dependencies required.\n- 🐼 Supports English and Chinese on Windows CMD, Powershell, Linux shell, etc.\n- 🤖 Compatible with GPT-3.5/4, DALL·E, Claude and Gemini APIs or the third parties.\n\n\n## Install\n\n```bash\npip install terminal-agent-x\n```\n\n## Config\n\nYou need to add the following environment variable:\n\n```bash\nexport tax_key=sk-xxx\nexport tax_base_url=YOUR_BASE_URL # optional, default: https://api.openai.com\n```\n\nGet your key from [OpenAI](https://platform.openai.com/account/api-keys) or Claude API key from [Anthropic](https://www.anthropic.com/claude/) and set it as `tax_key`.\n\n\n## Get Started\n\nYou can use the `tax \u003cprompt\u003e` to interact with the model, like:\n\n```bash\n$ tax write a python code for fibonacci\n```\n\n## Usage\n\n| Model | Command | Description |\n| :--- | :--- | :--- |\n| ChatGPT | `tax \u003cprompt\u003e` | Use `gpt-3.5-turbo` to generate content. |\n| ChatGPT | `tax \u003cprompt\u003e --code` | Use `gpt-3.5-turbo` to generate code. If only one line is generated, it will be executed automatically with your permission. |\n| GPT-4o-mini | `tax \u003cprompt\u003e -m gpt-4o-mini` | Use GPT-4o-mini to generate content. |\n| GPT-4o | `tax -i image_path -m gpt-4o \u003cprompt\u003e` | Upload an image and use GPT-4o to chat. |\n| DALL·E 3 | `tax \u003cprompt\u003e -m dalle` | Use DALL·E 3 to generate image. Currently, only one `1024x1024` image can be generated at a time. |\n| Claude | `tax \u003cprompt\u003e -m claude` | Use Claude to generate content. Use `-k your_claude_key` if you have set key in the environment variable. Only support single chat now. |\n| Gemini Pro |  `tax \u003cprompt\u003e -m gemini-pro` | Use Gemini to generate content. Also support `-k google_api_key`. Only support single chat now. |\n| Gemini Pro (Vision) | `tax -i image_path -m gemini-pro-vision \u003cprompt\u003e` | Upload an image and use Gemini Vision to chat. Also support `-k google_api_key`. |\n\n\n| Mode | Command | Description |\n| :--- | :--- | :--- |\n| Chat with selected model | `tax -m model_name -c` |  Chat with the selected model. |\n| Use a third-party base url and key | `tax \u003cprompt\u003e -u \u003cbase_url\u003e -k \u003ckey\u003e`| The url and key will be use before the environment variable. |\n| Save result to file | `tax \u003cprompt\u003e -o \u003coutput_file\u003e` | Save response to a file. |\n| Read prompts from file| `tax --prompt_file \u003cprompt_file\u003e` | Read prompt from file, one prompt per line. Please ensure tht you have enough quota. |\n| Parallel processing | `tax -p --prompt_file input.txt -o output.txt --option max_workers=3 --option chat_mode=openai` | Set more options for parallel processing. For example, `--option max_workers=3` means that you can run 3 processes at the same time. |\n\n\n## Attention!\n\nYou can see a directive after the generated command that says\n```\nDo you want to execute the command? (y/n)\n```\nPlease execute it or not at your own discretion. I am not responsible for the consequences of generated commands.\n\n## License\n\n[GNU General Public License v3.0](LICENSE)\n\n## Development Logs\n\n\u003cdetails\u003e\n\u003csummary\u003e0.1.x\u003c/summary\u003e\n\n#### 0.1.0\n\n- Implement basic functions\n- Support for Windows cmd and Linux shell\n- Add `--file` option for saving the response to a file\n\n#### 0.1.1\n\n- Add `--show_all` option for showing all contents of the response.\n- Add `--url` option for users not under GFW.\n- Add support for Windows Powershell\n\n#### 0.1.2\n\n- Add Anthropic Claude API Support. Thanks to [jtsang4/claude-to-chatgpt](https://github.com/jtsang4/claude-to-chatgpt). (deprecated in 0.1.5) \n- Add Support for Chinese on Linux and Windows. (also add a temporary solution for VSCode Terminal on Windows).\n- Add a timeout function.\n- Fix: C++ code block prefix.\n\n#### 0.1.3\n\n- Fix: code block prefix bug (tax will act maybe a little faster).\n- Modify: simplify the code.\n- Test: test for multi-process. Now you can use tax more efficiently in terminal.\n\n#### 0.1.4\n\n- Feat: Add support for reading prompt from file.\n- Feat: Add support for DALL·E.\n- Fix: Resolve the bug of curl command on Windows platform using IPv6 address to access Claude.\n\n#### 0.1.5\n\n- Fix: Change api to a third-party proxy. Affected by GFW's DNS domain pollution, the original proxy is temporarily unavailable. `claude-to-chatgpt` is unavailable.\n\n#### 0.1.6\n\n- Feat: Add support for **Chat** on Linux. Now you can use tax as **ChatGPT CLI**!\n- Feat: Add support for native Anthropic Claude API on Linux Shell, Windows cmd and Powershell.\n\n#### 0.1.7\n\n- Feat: Add support for parallel processing with mode.\n\n#### 0.1.8\n\n- Feat: Add support for `gpt-4-vision-preview` model on all platforms (Beta feature). For example,\n    ```bash\n    $ tax -i logo.jpg -m gpt-4-vision-preview what is this?\n    This appears to be a logo or emblem for something called \"Most Creative Learning.\" The design features a stylized triangular shape, possibly an optical illusion known as a Penrose triangle, ...\n    ```\n- Refactor: Change the way of URL selection and image input.\n\n#### 0.1.9\n\n- Feat: Update DALL·E to `dall-e-3` model.\n- Refactor: Change the name of environment variable from `openai_key` to `tax_key`. And some options are also changed. Please check the help message for more details.\n- Fix: Fix the bug of `--code` option when generating code to file.\n\n### 0.1.10\n\n- Feat: Add support for Google Gemini Pro for single chat.\n- Feat: Add support for Google Gemini Pro Vision (Beta feature).\n- Feat: Add support for stream mode of OpenAI.\n\n### 0.1.11\n\n- Feat: Add support for Anthropic Claude 3 Opus/Sonnet(Vision) API.\n\n\u003c/details\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flyulumos%2Fterminal-agent-x","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flyulumos%2Fterminal-agent-x","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flyulumos%2Fterminal-agent-x/lists"}