{"id":50133241,"url":"https://github.com/toxy4ny/nikki-ai-cli-assistent","last_synced_at":"2026-06-23T04:30:27.647Z","repository":{"id":328363461,"uuid":"1115286267","full_name":"toxy4ny/nikki-ai-cli-assistent","owner":"toxy4ny","description":"🫡 Nikki — AI Assistant for Red Team \u0026 DevOps in the Terminal (fish-shell)","archived":false,"fork":false,"pushed_at":"2025-12-13T09:15:27.000Z","size":23,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-14T07:36:00.254Z","etag":null,"topics":["ai","ai-agents","ai-assistant","cli","education","hacking","hacking-tool","hacking-tools","redteam","redteam-tools","redteaming","redteaming-tools"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/toxy4ny.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-12T16:09:26.000Z","updated_at":"2025-12-13T23:56:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/toxy4ny/nikki-ai-cli-assistent","commit_stats":null,"previous_names":["toxy4ny/nikki-ai-cli-assistent"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/toxy4ny/nikki-ai-cli-assistent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toxy4ny%2Fnikki-ai-cli-assistent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toxy4ny%2Fnikki-ai-cli-assistent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toxy4ny%2Fnikki-ai-cli-assistent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toxy4ny%2Fnikki-ai-cli-assistent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/toxy4ny","download_url":"https://codeload.github.com/toxy4ny/nikki-ai-cli-assistent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toxy4ny%2Fnikki-ai-cli-assistent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34675970,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-23T02:00:07.161Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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-agents","ai-assistant","cli","education","hacking","hacking-tool","hacking-tools","redteam","redteam-tools","redteaming","redteaming-tools"],"created_at":"2026-05-23T21:00:29.587Z","updated_at":"2026-06-23T04:30:27.641Z","avatar_url":"https://github.com/toxy4ny.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# 🫡 Nikki — AI Assistant for Red Team \u0026 DevOps in the Terminal\n\n\u003e **Nikki** is your local, offline, uncensored AI teammate in the CLI — purpose-built for:\n\u003e - generating battle-tested offensive code (PowerShell, C, Rust, Bash),\n\u003e - analyzing vulnerabilities and exploits from GitHub repositories,\n\u003e - writing and debugging scripts,\n\u003e - multi-turn conversations directly from your shell.\n\nAll processing happens **locally**, with **no cloud dependency** and **no prompt leakage**.  \nPowered by **aichat**, **Ollama**, **RAG**, and curated red team repositories like `PayloadsAllTheThings`, `Atomic Red Team`, and `SharpCollection` and top or new repositories of Github.\n\n---\n\n## 🌟 Key Features\n\n- ✅ **Fully offline** — works without internet after setup  \n- ✅ **No censorship** — uses uncensored `base` models  \n- ✅ **RAG over GitHub repos** — always up to date with latest offensive techniques  \n- ✅ **Multi-turn dialogue** via `--session`  \n- ✅ **Fish shell integration** — just type `Nikki ...`  \n- ✅ **Ready for [Athena OS](https://athenaos.org)** (Arch-compatible packaging) (https://github.com/Athena-OS)\n\n---\n\n## 🧠 Architecture\n\n```\n┌──────────────────────┐\n│       Nikki CLI      │ ← fish function: `Nikki`\n└──────────┬───────────┘\n           │\n   ┌───────▼──────────┐\n   │     aichat       │ ← Rust CLI frontend\n   └───────┬──────────┘\n           │\n   ┌───────▼──────────┐     ┌───────────────────────┐\n   │      Ollama      │◄───►│  RAG: nomic-embed-text│\n   │ (LLM + Embedding)│     └───────────────────────┘\n   └───────┬──────────┘\n           │\n   ┌───────▼──────────┐\n   │ GitHub Repos     │ ← PayloadsAllTheThings, SharpCollection, Atomic Red Team...\n   └──────────────────┘\n```\n\n- **LLMs**:  \n- `rnj-1-instruct` (uncensored, for red team)\n- **Embedding**: `nomic-embed-text` (local, via Ollama)\n- **Knowledge base**: cloned repos in `~/rag-data/redteam`\n- **Config**: roles, sessions, RAG — all in `~/.config/aichat/`\n\n---\n\n## ⚠️ Why This Isn’t Just “Another Chatbot”\n\n- Nikki **won’t hallucinate APIs** — if a technique isn’t in the source repos, she replies: _“No information found in my sources.”_\n- All payloads are **cross-referenced** with real repositories (use `.sources rag` to verify).\n- **Zero ethical disclaimers** — only working, executable code.\n\n---\n\n## 🛠 Installation\n\n### Requirements\n- **Athena OS** (or any Arch-based distro)\n- `aichat` ≥ 0.30.0\n- `ollama` ≥ 0.1.33\n- `git`, `fish`\n\n### Option 1: PKGBUILD (Recommended for Athena OS)\n\n```bash\ngit clone https://github.com/toxy4ny/nikki-ai-cli-assistent.git\ncd nikki-ai\nmakepkg -si\n```\n\n\u003e After install:\n\u003e - `Nikki` is available in your shell,\n\u003e - `setup-rag` updates your knowledge base,\n\u003e - config template: `/etc/aichat/config.yaml.example`\n\n### Option 2: Manual Install\n\n```bash\n./install.sh\n```\n\nInstalls:\n- `nikki.fish` → `~/.config/fish/functions/`\n- `setup-rag.fish` → `~/bin/`\n- config \u0026 role templates\n\n---\n\n## ⚙ Setup\n\n1. **Start Ollama**:\n   ```fish\n   systemctl --user enable --now ollama\n   ```\n\n2. **Pull models**:\n   ```fish\n   ollama pull rnj-1:latest\n   ollama pull nomic-embed-text\n   ```\n\n3. **Configure aichat** (manual install only):\n   ```fish\n   cp config/aichat-config.yaml ~/.config/aichat/config.yaml\n   ```\n\n4. **Load knowledge repos**:\n   ```fish\n   setup-rag\n   ```\n\n---\n\n## 💬 Usage\n\n### One-off query\n```fish\nNikki Generate a reverse TCP shell in bash?\n```\n\n### Multi-turn conversation\n```fish\nNikki --session c2 \"Generate a reverse TCP shell in C\"\nNikki --session c2 \"Add XOR encryption with key 0x42\"\nNikki --session c2 \"Compile it with mingw\"\n```\n\n### Verify sources (inside `aichat`)\n```fish\n\u003e .rag nikki-kb\n\u003e How does Unicorn do DDE attacks?\n\u003e .sources rag\n```\n\n---\n\n## 📦 Repository Structure\n\n```\nnikki-ai/\n├── PKGBUILD                # For Athena OS / AUR\n├── install.sh              # Manual install script\n├── bin/setup-rag.fish      # RAG update utility\n├── config/aichat-config.yaml\n├── roles/redteam-ru.yaml\n├── fish/nikki.fish\n├── LICENSE\n└── README.md\n```\n\n---\n\n## 🤝 Contribution \u0026 Athena OS Integration\n\nNikki aligns with **Athena OS philosophy**:\n- minimalism,\n- security,\n- offline-first,\n- open-source.\n\nWe welcome inclusion in the **official Athena OS repositories**.  \nThe project is audit-ready and supports automated builds.\n\n🔗 [Athena OS](https://athenaos.org)\n\n---\n\n## ⚠️ Ethical Notice\n\n\u003e Nikki is designed for **authorized** penetration testing, red team operations, and closed-lab education.  \n\u003e Do not use it for illegal activities.  \n\u003e Always review generated code before execution.\n\n---\n\n## 📜 License\n\nMIT © [toxy4ny](https://github.com/toxy4ny)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoxy4ny%2Fnikki-ai-cli-assistent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoxy4ny%2Fnikki-ai-cli-assistent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoxy4ny%2Fnikki-ai-cli-assistent/lists"}