{"id":51298980,"url":"https://github.com/holasoymalva/perplexity-core-framework","last_synced_at":"2026-06-30T17:31:46.535Z","repository":{"id":290873745,"uuid":"975066024","full_name":"holasoymalva/perplexity-core-framework","owner":"holasoymalva","description":"A professional framework for building intelligent applications with Perplexity AI","archived":false,"fork":false,"pushed_at":"2025-05-01T02:33:36.000Z","size":29,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-03T14:39:05.207Z","etag":null,"topics":["ai","framework","llm","llms","perplexity","perplexity-ai","perplexity-api","python","python-3","python-app","python-library","python-script","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","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/holasoymalva.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}},"created_at":"2025-04-29T18:18:41.000Z","updated_at":"2025-05-01T02:48:24.000Z","dependencies_parsed_at":"2025-05-01T03:28:59.590Z","dependency_job_id":"123ae0a8-4b06-4a3b-aa2e-80d37392c987","html_url":"https://github.com/holasoymalva/perplexity-core-framework","commit_stats":null,"previous_names":["holasoymalva/perplexity-core"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/holasoymalva/perplexity-core-framework","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fperplexity-core-framework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fperplexity-core-framework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fperplexity-core-framework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fperplexity-core-framework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/holasoymalva","download_url":"https://codeload.github.com/holasoymalva/perplexity-core-framework/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holasoymalva%2Fperplexity-core-framework/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34977667,"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-30T02:00:05.919Z","response_time":92,"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","framework","llm","llms","perplexity","perplexity-ai","perplexity-api","python","python-3","python-app","python-library","python-script","python3"],"created_at":"2026-06-30T17:31:44.902Z","updated_at":"2026-06-30T17:31:46.521Z","avatar_url":"https://github.com/holasoymalva.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Perplexity Core Framework\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://cdn.prod.website-files.com/5da60b8bfc98fdf11111b791/667d8a67dcf144284eeb44a5_What%20is%20Perplexity%20AI%20and%20How%20to%20Use%20It.webp\" alt=\"Perplexity Core Logo\" width=\"400\" height=\"200\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eA professional framework for building intelligent applications with Perplexity AI\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e •\n  \u003ca href=\"#virtual-environment\"\u003eVirtual Environment\u003c/a\u003e •\n  \u003ca href=\"#quickstart\"\u003eQuickstart\u003c/a\u003e •\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n  \u003ca href=\"#examples\"\u003eExamples\u003c/a\u003e •\n  \u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e •\n  \u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/holasoymalva/perplexity-core\" alt=\"License\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/stars/holasoymalva/perplexity-core\" alt=\"Stars\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/forks/holasoymalva/perplexity-core\" alt=\"Forks\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/issues/holasoymalva/perplexity-core\" alt=\"Issues\"\u003e\n\u003c/p\u003e\n\n## 🚀 Overview\n\nPerplexity Core is an enterprise-grade Python framework designed to accelerate development of AI applications using the Perplexity API. Built with flexibility, scalability, and developer experience in mind, it provides a robust foundation for everything from simple prototypes to production-ready AI systems.\n\nThe framework abstracts away the complexities of working with Perplexity's sophisticated AI models, allowing developers to focus on building innovative features rather than managing API interactions.\n\n## ✨ Features\n\n- **Comprehensive Client**: Full support for all Perplexity API capabilities with an elegant, Pythonic interface\n- **Flexible Configuration System**: Environment variables, JSON files, and programmatic options for seamless integration in any environment\n- **Enterprise-Ready Logging**: Robust logging system ready for production deployments\n- **Structured Data Models**: Type-hinted models for responses and reliable data handling\n- **Response Processing Tools**: Ready-to-use utilities for format conversion, citation extraction, and more\n- **Streaming Support**: Built-in handling for streaming responses\n- **Full Test Coverage**: Comprehensive test suite ensuring reliability\n- **Extensive Documentation**: Complete references and examples for rapid onboarding\n\n## 🛠️ Installation\n\n## 🔮 Virtual Environment\n\n### Setting up a Virtual Environment\n\nWe strongly recommend using a virtual environment for development:\n\n```bash\n# Clone the repository\ngit clone https://github.com/holasoymalva/perplexity-core.git\ncd perplexity-core\n\n# Create a virtual environment\npython -m venv venv\n\n# Activate the virtual environment\n# On Windows:\nvenv\\Scripts\\activate\n# On macOS/Linux:\nsource venv/bin/activate\n\n# Install dependencies\npip install -r requirements.txt\n\n# Or install in development mode\npip install -e .[dev]\n```\n\nYou'll know your virtual environment is active when you see `(venv)` prefixed to your command prompt.\n\nTo deactivate the virtual environment when you're done:\n\n```bash\ndeactivate\n```\n\n## 🧩 Quickstart\n\nSet up your API key:\n\n```bash\nexport PERPLEXITY_API_KEY=\"your-api-key-here\"\n```\n\nThen in your code:\n\n```python\nfrom src.perplexity_client import PerplexityClient\n\n# Initialize the client\nclient = PerplexityClient()\n\n# Simple query\nresponse = client.query(\n    \"What are the potential applications of AI in healthcare?\",\n    model=\"sonar-medium-online\"\n)\n\n# Print the response\nprint(response.content)\n\n# Use the search capability\nsearch_results = client.search(\"latest advancements in quantum computing\")\nprint(search_results.content)\n```\n\n## 🔍 Examples\n\nThe repository includes complete examples to jumpstart your development:\n\n### Basic Usage\n\n```bash\npython examples/basic_example.py\n```\n\nThis demonstrates fundamental query operations with the API.\n\n### Advanced Features\n\n```bash\npython examples/advanced_example.py\n```\n\nCovers advanced usage including streaming responses, custom parameters, search functionality, and context handling.\n\n## 📚 Documentation\n\nFind comprehensive documentation in the code or visit our [documentation site](#) (coming soon).\n\nEach module and function includes detailed docstrings explaining parameters, return values, and examples.\n\n### Managing Your Environment\n\nFor team collaboration and deployment consistency, we recommend:\n\n```bash\n# Save your current environment dependencies\npip freeze \u003e requirements-lock.txt\n\n# Create an environment from a requirements file\npip install -r requirements-lock.txt\n```\n\nThis ensures all team members and deployment environments have identical dependencies.\n\n## 🧠 Architecture\n\nPerplexity Core follows a modular design to maximize flexibility:\n\n```\nperplexity-core/\n├── src/                   # Core source code\n│   ├── perplexity_client.py   # Main client interface\n│   ├── models/            # Data models\n│   ├── utils/             # Utilities (config, logging)\n│   └── handlers/          # Response processors\n├── examples/              # Example implementations\n├── tests/                 # Test suite\n```\n\n## 🔧 Configuration\n\nPerplexity Core offers multiple configuration methods:\n\n- **Environment Variables**: `PERPLEXITY_API_KEY`, `PERPLEXITY_ENV`, etc.\n- **Configuration Files**: JSON files in standard locations\n- **Programmatic Configuration**: Directly via the `Config` class\n\nExample configuration file:\n\n```json\n{\n  \"api_key\": \"your-api-key\",\n  \"model\": \"sonar-medium-online\",\n  \"temperature\": 0.7\n}\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgements\n\n- [Perplexity AI](https://perplexity.ai) for their powerful AI models and API\n- Contributors and early adopters\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ❤️ in Mexico City\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003ePerplexity Core\u003c/strong\u003e • Elevating AI Development\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fholasoymalva%2Fperplexity-core-framework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fholasoymalva%2Fperplexity-core-framework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fholasoymalva%2Fperplexity-core-framework/lists"}