Skip to content

Changed commands and fixed major bugs #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
JayRaj21 wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Changed commands and fixed major bugs #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3963f39
Changed commands and fixed major bugs
JayRaj21 Mar 20, 2026
00edda1
Updated readme
JayRaj21 Mar 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 8 additions & 2 deletions INSTALL_GUIDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@
- Python 3.8 or newer
- [Ollama](https://ollama.com) — installed automatically during setup if not present

**A GPU is not required.** DaemonIQ runs entirely on your CPU. If you do have a GPU, Ollama will use it automatically to speed things up — but if you don't, everything works the same, just a little slower.

Check your Python version:

```bash
Expand Down Expand Up @@ -67,11 +69,15 @@ Qwen2.5 comes in several sizes. The wizard maps your RAM to the right one:
| 24 GB+ | qwen2.5:32b | ~20 GB |
| Not sure | qwen2.5:7b | ~5 GB |

**You do not need a GPU for any of these.** Ollama runs on CPU by default. If your machine has a compatible GPU (NVIDIA, AMD, or Apple Silicon), Ollama will detect and use it automatically for faster responses. If not, the model runs on CPU — responses will be a bit slower, but the quality is identical.

If you are unsure whether your machine can handle Sovereign, choose Imp — it works well on almost any modern laptop or desktop.

---

## Ollama

Both Imp and Demon use Ollama to run the model locally. If Ollama is not installed, the setup wizard will offer to install it for you. To install it manually:
Both Imp and Sovereign use Ollama to run the AI model locally on your machine. If Ollama is not installed, the setup wizard will offer to install it for you. To install it manually:

```bash
curl -fsSL https://ollama.com/install.sh | sh
Expand All @@ -81,7 +87,7 @@ To pull a model manually instead of through the wizard:

```bash
ollama pull llama3 # Imp
ollama pull qwen2.5:14b # Demon — adjust tag to match your RAM
ollama pull qwen2.5:14b # Sovereign — adjust tag to match your RAM
```

Ollama resumes interrupted downloads, so if a large model download fails partway through, simply run the pull command again.
Expand Down
94 changes: 46 additions & 48 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# DaemonIQ

A Linux troubleshooting assistant that runs as a background demon on your machine. Describe a problem in plain English — it diagnoses it, suggests a fix, and can apply the fix if you ask it to. It runs as a background process, always ready.
A Linux troubleshooting assistant that runs as a background process on your machine. Describe a problem in plain English — it diagnoses it, suggests a fix, and can apply the fix if you ask it to.

No cloud API. No account required. Runs entirely on your hardware using a local AI model via [Ollama](https://ollama.com).

Expand Down Expand Up @@ -65,14 +65,13 @@ Built-in knowledge covers `apt`, `dpkg`, `pip`, `snap`, and `flatpak`; NVIDIA, A

## Commands

### Interactive session
### Starting DaemonIQ

| Command | Description |
|---------|-------------|
| `daemoniq` | Start an interactive session |
| `daemoniq "question"` | One-shot question, no session |
| `daemoniq "question"` | Ask a single question and exit |
| `daemoniq --exec "question"` | Ask and automatically apply the fix |
| `daemoniq --session NAME "question"` | Ask within a named session |
| `daemoniq --no-color` | Disable colour output |

### Inside a session
Expand All @@ -81,32 +80,33 @@ Built-in knowledge covers `apt`, `dpkg`, `pip`, `snap`, and `flatpak`; NVIDIA, A
|---------|-------------|
| `exec on` | Apply fixes automatically when suggested |
| `exec off` | Show fixes without applying them (default) |
| `clear` | Clear conversation history for this session |
| `history` | Show the last 20 recorded shell commands |
| `status` | Show whether the background process is running and which model is active |
| `distro` | Show detected distro and package managers |
| `help` | List available commands |
| `exit` | Close the interactive session (the background process keeps running) |
| `clear` | Wipe the conversation history and start fresh |
| `history` | Show your last 20 recorded shell commands |
| `info` | Show status, distro, model, and package managers |
| `hardware` | Show detected hardware, drivers, and kernel errors |
| `help` | Show the help menu |
| `close` | Close this session (program keeps running in background) |
| `stop` | Shut down the program completely |

> `close` also accepts `quit` and `q`. `stop` also accepts `end`.

### Managing the background process

| Command | Description |
|---------|-------------|
| `daemoniq start` | Start the background process manually |
| `daemoniq start` | Start the background process |
| `daemoniq stop` | Stop the background process |
| `daemoniq restart` | Stop and restart the background process |
| `daemoniq status` | Show PID, distro, backend, and hardware summary |
| `daemoniq logs` | Stream the live log output of the background process |
| `daemoniq logs` | Stream the live log output |

### Configuration
### Configuration and information

| Command | Description |
|---------|-------------|
| `daemoniq setup` | Re-run the setup wizard |
| `daemoniq distro` | Show detected distro and package managers |
| `daemoniq info` | Show status, distro, model, and package managers |
| `daemoniq hardware` | Show hardware snapshot — GPU, drivers, dmesg errors |
| `daemoniq history` | Show the last 50 recorded shell commands |
| `daemoniq sessions` | List active named sessions |
| `daemoniq setup` | Re-run the setup wizard |

### Updates and maintenance

Expand All @@ -118,47 +118,45 @@ Built-in knowledge covers `apt`, `dpkg`, `pip`, `snap`, and `flatpak`; NVIDIA, A
| `daemoniq rollback` | Restore the previous version |
| `daemoniq uninstall` | Remove DaemonIQ from this machine |

### Sessions

Sessions maintain separate conversation histories, which is useful when working across different machines or projects at once:

```bash
daemoniq --session server "nginx won't start after the last upgrade"
daemoniq --session laptop "bluetooth keeps disconnecting"
daemoniq sessions
```

The default session is named `default`.

---

## Quick reference

```
daemoniq Start a session
daemoniq "question" One-shot question
daemoniq --exec "question" Ask and apply fix
daemoniq --session NAME "q" Named session

daemoniq setup Re-run setup
daemoniq start / stop / restart Start, stop, or restart the background process
daemoniq status / logs Check health and stream live log output
daemoniq distro / hardware System info
daemoniq history / sessions History and sessions
daemoniq version / update Version and patching
daemoniq rollback / uninstall Recovery and removal

In a session:
exec on / off Toggle auto-apply
clear Reset conversation
exit End session
daemoniq Start a session
daemoniq "question" Ask a single question
daemoniq --exec "question" Ask and auto-apply the fix

daemoniq start Start the background process
daemoniq stop Stop the background process
daemoniq restart Restart the background process
daemoniq logs View live logs
daemoniq info Show status and system info
daemoniq hardware Show hardware and driver info
daemoniq history Show recorded shell commands
daemoniq setup Re-run setup wizard
daemoniq version Show installed version
daemoniq update Apply a patch
daemoniq rollback Restore previous version
daemoniq uninstall Remove DaemonIQ

Inside a session:
exec on Apply fixes automatically
exec off Show fixes, do not apply (default)
clear Wipe conversation history
history Show shell command history
info Show status and system info
hardware Show hardware and driver info
help Show the help menu
close Close this session
stop Shut down completely
```

---

## Notes

- Requires Python 3.8+ and [Ollama](https://ollama.com)
- Nothing is installed system-wide — all files live under `~/.daemoniq-demon/` (the background process install directory)
- "DaemonIQ" is a working name. To rename it, edit the `BRANDING` block at the top of any variant script
- A GPU is not required — DaemonIQ runs on CPU. If a GPU is present, Ollama will use it automatically.
- Nothing is installed system-wide — all files live under `~/.daemoniq-demon/`
- Full installation instructions: [INSTALL_GUIDE.md](INSTALL_GUIDE.md)
Loading