{"id":17873935,"url":"https://github.com/lucianoayres/catnip","last_synced_at":"2025-04-02T23:43:42.056Z","repository":{"id":259680469,"uuid":"879080501","full_name":"lucianoayres/catnip","owner":"lucianoayres","description":"Catnip is an AI model designed to help you generate comprehensive categories related to your topics or areas of interest. By leveraging Ollama, Catnip simplifies the process of organizing and categorizing information, enabling you to create customized AI assistants that generate detailed category lists tailored to your needs.","archived":false,"fork":false,"pushed_at":"2024-11-09T09:50:57.000Z","size":2465,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-08T14:11:45.785Z","etag":null,"topics":["ai-model","category-generator","modelfile","ollama","prompt-engineering"],"latest_commit_sha":null,"homepage":"","language":null,"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/lucianoayres.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":"2024-10-26T23:10:12.000Z","updated_at":"2024-11-09T09:51:01.000Z","dependencies_parsed_at":"2024-11-09T10:35:54.157Z","dependency_job_id":null,"html_url":"https://github.com/lucianoayres/catnip","commit_stats":null,"previous_names":["lucianoayres/catnip"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucianoayres%2Fcatnip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucianoayres%2Fcatnip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucianoayres%2Fcatnip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucianoayres%2Fcatnip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lucianoayres","download_url":"https://codeload.github.com/lucianoayres/catnip/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246911489,"owners_count":20853654,"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":["ai-model","category-generator","modelfile","ollama","prompt-engineering"],"created_at":"2024-10-28T11:06:07.547Z","updated_at":"2025-04-02T23:43:42.025Z","avatar_url":"https://github.com/lucianoayres.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🐱 Catnip\n\n![catnip-banner](https://github.com/lucianoayres/catnip/blob/main/images/banner_catnip.png?raw=true)\n\n## Generate Comprehensive Categories for Any Topic Effortlessly\n\n[What's Catnip? 🐱](#whats-catnip) · [Why Use Catnip? 🚀](#why-use-catnip) · [How Does It Work? ⚙️](#how-does-it-work) · [Who Is It For? 🎯](#who-is-it-for) · [Modes of Catnip 🎛️](#modes-of-catnip) · [How to Use 🛠️](#how-to-use) · [Using Nino with Ollama 🐶](#using-nino-with-ollama) · [Templates 📄](#templates) · [Examples 📂](#examples) · [License 📄](#license) · [Contribution 🤝](#contribution)\n\n### What's Catnip? 🐱\n\n**Catnip** is an AI model designed to help you generate comprehensive categories related to your topics or areas of interest. By leveraging [Ollama](https://github.com/ollama/ollama), Catnip simplifies the process of organizing and categorizing information, enabling you to create customized AI assistants that generate detailed category lists tailored to your needs.\n\nCatnip offers two modes to suit your needs:\n\n-   **Catnip Panorama** 🌄: Generates a comprehensive list of categories related to your topic.\n-   **Catnip Spotlight** 🔦: Provides a single, randomly selected category relevant to your topic.\n\n### Why Use Catnip? 🚀\n\n-   **Effortless Brainstorming 🔍**: Automatically generate detailed category lists or discover a single category for any topic.\n-   **Enhanced Organization ⏳**: Organize complex subjects into manageable categories quickly.\n-   **Customizable Output 🎨**: Tailor the AI assistant to produce categories that suit your specific needs.\n-   **Versatility 🔄**: Fully compatible with [Ollama](https://github.com/ollama/ollama), ensuring seamless model creation and deployment.\n\n### How Does It Work? ⚙️\n\nCatnip uses Modelfiles that define AI models capable of generating comprehensive category lists or providing a single category based on user-provided input. By creating these models with Ollama, you can interact with Catnip in the mode that best suits your needs.\n\n## Who Is It For? 👥\n\nCatnip is for anyone who wants to organize and categorize information more effectively:\n\n-   **Students 📚**: For creating study guides and breaking down complex subjects.\n-   **Researchers 🔬**: To map out areas of study and identify key categories.\n-   **Content Creators ✍️**: For outlining content topics and subtopics.\n-   **Educators 👩‍🏫**: To develop structured curricula and lesson plans.\n-   **Business Analysts 📈**: For organizing business domains and market segments.\n-   **Project Managers 📋**: To break down projects into manageable categories.\n\n## Modes of Catnip 🎛️\n\n### Catnip Panorama 🌄\n\nGenerates a comprehensive list of categories related to your topic. Ideal for when you need an extensive overview or are brainstorming multiple aspects of a subject.\n\n### Catnip Spotlight 🔦\n\nProvides a single, randomly selected category relevant to your topic. Great for when you need a quick idea or focus point without the overload of a full list.\n\n## How to Use 🛠️\n\nFollow these steps to use Catnip and generate comprehensive category lists or a single category:\n\n### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/lucianoayres/catnip.git\ncd catnip\n```\n\n### 2. Ensure Ollama is Installed\n\nMake sure you have [Ollama](https://github.com/ollama/ollama) installed on your system.\n\n### 3. Create the Catnip Models\n\n#### For Catnip Panorama\n\n```bash\nollama create catnip-panorama1.0 -f ./modelfiles/Catnip-Panorama1.0\n```\n\n#### For Catnip Spotlight\n\n```bash\nollama create catnip-spotlight1.0 -f ./modelfiles/Catnip-Spotlight1.0\n```\n\n### 4. Run Catnip\n\n#### Using Catnip Panorama\n\n```bash\nollama run catnip-panorama1.0\n```\n\n#### Using Catnip Spotlight\n\n```bash\nollama run catnip-spotlight1.0\n```\n\n### 5. Provide Your Topic or Area\n\nWhen prompted, input your topic or area of interest. For example:\n\n```\nModern Programming Languages\n```\n\n### 6. Review the Output\n\n-   **Catnip Panorama** will output a comprehensive list of categories based on your input.\n-   **Catnip Spotlight** will output a single, randomly selected category relevant to your topic.\n\n### 7. Save the Output (Optional)\n\nYou can copy the output and save it as a plain text file for future reference.\n\n## Using Nino with Ollama 🐶\n\nYou can also use [**Nino**](https://github.com/lucianoayres/nino-cli) to interact with your Ollama models more freely. Nino allows you to send prompts directly to the models from the command line without entering interactive mode, and it also allows you to export the AI's response to a local file.\n\n### Example Commands\n\n#### Using Catnip Panorama\n\n```bash\nnino \"Mathematics for Computer Science\" --model catnip-panorama1.0 --output categories.txt\n```\n\n#### Using Catnip Spotlight\n\n```bash\nnino \"Mathematics for Computer Science\" --model catnip-spotlight1.0 --output category.txt\n```\n\n## Templates 📄\n\n### Structure 🏗️\n\nThe Catnip templates streamline task definition by organizing key components, making it easy to configure and customize AI models while ensuring compatibility with Ollama. The structure includes:\n\n1. **Objective and Rules** 📜: Defines the assistant's purpose and lays out guidelines to ensure the generated output meets your needs.\n\n2. **Command Specification** 🍳: Details essential commands used in a Modelfile, such as:\n\n    - **META**: Contains metadata about the Modelfile, added as comments.\n    - **FROM**: Specifies the base model version (e.g., `llama2`).\n    - **PARAMETER**: Sets model parameters like `temperature`, `num_ctx`, and `top_p`.\n    - **MESSAGE**: Provides initial messages or prompts for the assistant.\n    - **LICENSE**: Includes licensing information for the Modelfile.\n\n3. **Template and Configuration** 🧩: Offers a standard Modelfile template with placeholders (`\u003c\u003c \u003e\u003e`) that can be customized based on your specific idea, goal, or problem.\n\n4. **User Input** 💡: The specific idea, goal, or problem to generate the most effective output.\n\n### Using Modelzilla 🦖 to Generate Custom AI Models\n\nWe recommend using [**Modelzilla**](https://github.com/lucianoayres/modelzilla) 🦖 to generate custom-tailored AI models. Modelzilla can help you create Modelfiles for your specific tasks, allowing you to build personalized AI assistants that are perfectly suited to your needs.\n\n### Prompts\n\nThe original prompt templates are available for reference in the [prompts directory](./prompts). These resources are valuable for understanding the structure of Modelfiles and can serve educational purposes.\n\n## Examples 📂\n\n### Catnip Panorama Examples 📝\n\nExamples of prompts you can provide to Catnip Panorama:\n\n-   **Topic**: \"Renewable Energy Technologies\"\n-   **Area**: \"Ancient Civilizations\"\n-   **Field**: \"Artificial Intelligence Applications\"\n\n#### Output Example\n\nFor the topic \"Renewable Energy Technologies,\" Catnip Panorama might generate:\n\n-   Solar Energy\n-   Wind Energy\n-   Hydroelectric Power\n-   Geothermal Energy\n-   Biomass Energy\n-   Tidal Energy\n-   Wave Energy\n-   Hydrogen Fuel Cells\n\n### Catnip Spotlight Examples 📝\n\nExamples of prompts you can provide to Catnip Spotlight:\n\n-   **Topic**: \"Renewable Energy Technologies\"\n-   **Area**: \"Ancient Civilizations\"\n-   **Field**: \"Artificial Intelligence Applications\"\n\n#### Output Example\n\nFor the topic \"Renewable Energy Technologies\", Catnip Spotlight might output:\n\n-   Tidal Energy\n\n## License 📄\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n\n## Contribution 🤝\n\nContributions are welcome! Please fork the repository and submit a pull request if you'd like to propose any changes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucianoayres%2Fcatnip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flucianoayres%2Fcatnip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucianoayres%2Fcatnip/lists"}