https://github.com/mbrell/c0admin
A terminal-based AI assistant for Linux sysadmins.
https://github.com/mbrell/c0admin
admin bash c0admin devops docker gemini googlegemini linux linux-administration python shell sysadmin
Last synced: 5 months ago
JSON representation
A terminal-based AI assistant for Linux sysadmins.
- Host: GitHub
- URL: https://github.com/mbrell/c0admin
- Owner: mbrell
- License: gpl-3.0
- Created: 2025-06-28T13:39:18.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-07-05T19:58:45.000Z (5 months ago)
- Last Synced: 2025-07-05T20:45:05.040Z (5 months ago)
- Topics: admin, bash, c0admin, devops, docker, gemini, googlegemini, linux, linux-administration, python, shell, sysadmin
- Language: Python
- Homepage:
- Size: 512 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cli-apps - c0admin - A terminal-based AI assistant for Linux sysadmins. Uses the Gemini API. (<a name="ai-cli-commands"></a>AI terminal command generator)
- awesome-cli-apps-in-a-csv - c0admin - A terminal-based AI assistant for Linux sysadmins. Uses the Gemini API. (<a name="ai-cli-commands"></a>AI terminal command generator)
README
Soon.. 👀
Of course after INSTALL.sh....
# c0admin
Suggests GNU/Linux terminal commands from natural language using AI.
> [!IMPORTANT]
> INSTALL.sh will work soon...
> [!WARNING]
> For the automatic copy to clipboard feature to work, you must have the ‘xsel’ and ‘xclip’ packages installed on your system.
[How to get personal Google Gemini API key?](https://github.com/mbrell/c0admin/blob/main/how-to-get-gemini-api-key.md)
## Installation
1. Clone the repository:
```bash
git clone https://github.com/mbrell/c0admin.git
cd c0admin
```
2. Create a virtual environment (recommended):
```bash
python -m venv venv
source venv/bin/activate
```
3. Install dependencies:
```bash
pip install -r requirements.txt
```
## Usage
Start the application:
```bash
python3 main.py
```
or
Start the minimal version of the application:
```bash
python3 main-minimal.py
```
## Commands
- `--help`
- `/del` — Delete the GEMINI API KEY.
- `/exit` — Exit the app safely.
- `/help` — Redirects to repository.
- `/history` — Displays the command history (history.txt).
- `/setinst ` — Set a custom system instruction from a given URL.
- `/resetinst` — Reset system instruction to the default one.
## Custom System Instructions
From the [system-instructions](https://github.com/mbrell/c0admin/tree/main/system-instructions) folder in the repo you can see all the community-created system instructions.
We welcome your contributions on this issue.
## Contributing
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
---
Built with ❤️ using Python