{"id":22147811,"url":"https://github.com/rudrodip/askitty","last_synced_at":"2025-07-26T02:32:02.888Z","repository":{"id":238342095,"uuid":"796357760","full_name":"rudrodip/askitty","owner":"rudrodip","description":"A simple CLI tool to interact with generative models like llms and image generation apis.","archived":false,"fork":false,"pushed_at":"2024-06-12T13:52:54.000Z","size":380,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-01T13:49:50.496Z","etag":null,"topics":["async-rust","cargo","dalle3","groq","openai","replicate","rust","rust-ai","serde-json","stable-diffusion","termimad","tokio"],"latest_commit_sha":null,"homepage":"https://askitty.rdsx.dev","language":"Rust","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/rudrodip.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2024-05-05T17:48:31.000Z","updated_at":"2024-10-26T09:26:54.000Z","dependencies_parsed_at":"2024-06-12T19:31:35.614Z","dependency_job_id":"5fb776fe-5456-4e6b-9843-c13209209c5b","html_url":"https://github.com/rudrodip/askitty","commit_stats":null,"previous_names":["rudrodip/askitty"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudrodip%2Faskitty","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudrodip%2Faskitty/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudrodip%2Faskitty/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rudrodip%2Faskitty/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rudrodip","download_url":"https://codeload.github.com/rudrodip/askitty/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227643022,"owners_count":17797977,"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":["async-rust","cargo","dalle3","groq","openai","replicate","rust","rust-ai","serde-json","stable-diffusion","termimad","tokio"],"created_at":"2024-12-01T23:21:32.467Z","updated_at":"2024-12-01T23:21:34.529Z","avatar_url":"https://github.com/rudrodip.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# askitty\n\n![askitty](https://github.com/rudrodip/askitty/assets/77154365/e7a832f5-a45b-4999-b762-77a19992614e)\n\n## Description\n\n`askitty` is a simple CLI tool designed to interact with generative models like large language models (LLMs) and image generation APIs. The tool supports various features, including chat history, new chat session commands, global and individual system prompts, and more.\n\nCheck out this [demo](https://x.com/rds_agi/status/1793998351782007104) video\n      \n## Features\n\n- **LLM API**: Supports any LLM that follows the OpenAI/v1 spec.\n- **Image Generation API**: Supports any image generation API that follows the OpenAI/v1 spec.\n- **Chat History**: View and manage chat history.\n- **Sessions**: Start new sessions, view existing sessions, and delete sessions.\n- **System Prompts**: Set and manage global and session-specific prompts.\n- **Configuration**: Set and view global configuration.\n- **Error Handling**: Robust error handling for a seamless experience.\n- **Markdown Preview**: Preview messages in Markdown format.\n\n## Installation\n\nTo get started with `askitty`, you can use the following command to download and install the latest release:\n\n```bash\ncurl -sSL https://askitty.rdsx.dev/install.sh | bash\n```\n\n## Usage\n\nOnce installed, you can use `askitty` from the command line with the following syntax:\n\n```bash\naskitty [FLAG] [MESSAGE]\n```\n\n### Flags\n\n- `-h, --help`                          Display help message\n- `-v, --version`                       Display version\n- `-m, --message`                       Message to send to the model\n- `-i, --imagine`                       Generate image from text\n- `-r, --repl`                          Start a REPL\n- `-n, --new`                           Start a new session\n- `-s, --sessions`                      View all sessions\n- `-s \u003csession_id\u003e`                     View a specific session\n- `-d \u003csession_id\u003e`                     Delete a specific session\n- `-c, --clear`                         Clear all sessions\n- `-p, --prompt`                        Set global system prompt\n- `-p \u003csession_id\u003e`                     Set a specific session prompt\n- `-ps, --prompt-show`                  Show global system prompt\n- `-pc, --prompt-clear`                 Clear global system prompt\n- `-pd, --prompt-delete \u003csession_id\u003e`   Delete a specific session prompt\n- `-vc, --view-config`                  View global configuration\n- `-sc, --set-config`                   Set global configuration\n\n## Examples\n\n### Sending a Message to the Model\n\n```bash\naskitty -m \"Hello, how are you?\"\n```\n\n### Generating an Image from Text\n\n```bash\naskitty -i \"A beautiful sunset over the mountains\"\n```\n\n### Starting a New Session\n\n```bash\naskitty -n\n```\n\n### Viewing All Sessions\n\n```bash\naskitty -s\n```\n\n### Viewing a Specific Session\n\n```bash\naskitty -s \u003csession_id\u003e\n```\n\n### Setting a Global System Prompt\n\n```bash\naskitty -p \"You are a helpful assistant.\"\n```\n\n## Contributing\n\nContributions are welcome! Please fork the repository and submit a pull request with your changes.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE.md) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frudrodip%2Faskitty","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frudrodip%2Faskitty","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frudrodip%2Faskitty/lists"}