{"id":26418591,"url":"https://github.com/yasharthbajpai/truth-seeker-python","last_synced_at":"2025-08-09T14:03:31.385Z","repository":{"id":282764561,"uuid":"949583561","full_name":"yasharthbajpai/Truth-Seeker-Python","owner":"yasharthbajpai","description":"A Python-based fact-checking assistant that uses the Perplexity API to verify claims, providing verdicts, explanations, and corrections with a user-friendly colored terminal interface.","archived":false,"fork":false,"pushed_at":"2025-03-16T19:27:25.000Z","size":10706,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-16T20:32:24.048Z","etag":null,"topics":["api","perplexity-api","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/yasharthbajpai.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":"2025-03-16T19:16:13.000Z","updated_at":"2025-03-16T19:46:45.000Z","dependencies_parsed_at":"2025-03-16T20:42:46.574Z","dependency_job_id":null,"html_url":"https://github.com/yasharthbajpai/Truth-Seeker-Python","commit_stats":null,"previous_names":["yasharthbajpai/truth-seeker-python"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yasharthbajpai%2FTruth-Seeker-Python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yasharthbajpai%2FTruth-Seeker-Python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yasharthbajpai%2FTruth-Seeker-Python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yasharthbajpai%2FTruth-Seeker-Python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yasharthbajpai","download_url":"https://codeload.github.com/yasharthbajpai/Truth-Seeker-Python/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244141576,"owners_count":20404835,"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":["api","perplexity-api","python3"],"created_at":"2025-03-18T01:48:43.496Z","updated_at":"2025-03-18T01:48:44.068Z","avatar_url":"https://github.com/yasharthbajpai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Truth Seeker 🕵️‍♀️\n\nA Python-based fact-checking tool that leverages the Perplexity API to verify claims and statements, providing clear verdicts, explanations, and corrections with a user-friendly colored terminal interface.\n\n## Features\n\n- **Real-time Fact Checking**: Verify the accuracy of statements and claims using Perplexity AI\n- **Structured Results**: Get clear verdicts (True, Partially True, False, or Undetermined)\n- **Detailed Explanations**: Understand the reasoning behind each verdict\n- **Suggested Corrections**: Receive corrections for inaccurate information\n- **Colorful Terminal Interface**: Easy-to-read color-coded results with emoji indicators\n- **Save Results**: Option to save fact-check results to text files for future reference\n\n## Installation\n\n1. Clone this repository:\n   ```\n   git clone https://github.com/yourusername/truth-seeker.git\n   cd truth-seeker\n   ```\n\n2. Install the required dependencies:\n   ```\n   pip install -r requirements.txt\n   ```\n\n3. Create a `.env` file in the project directory with your Perplexity API key:\n   ```\n   PERPLEXITY_API_KEY=pplx-\n   PERPLEXITY_MODEL=sonar-pro\n   ```\n\n## Usage\n\nRun the program:\n```\npython fact_checker.py\n```\n\nFollow the interactive prompts:\n1. Enter the statement you want to fact-check\n2. Review the verdict, explanation, and corrections\n3. Choose whether to save the results\n4. Continue with another fact-check or exit\n\n## Example\n\n```\n=== FACT CHECKING ASSISTANT 🕵️‍♀️ ===\nThis program will help you verify the accuracy of statements and claims.\n\n------------------------------------------------------------\nEnter the statement or claim you want to fact-check 🔍\n(or type 'exit' to quit):\n\n\u003e The Earth is flat\n\nFact-checking in progress... 🔍\n\n============================================================\nFACT CHECK RESULTS ✅\n============================================================\n\nCLAIM: 💬\nThe Earth is flat\n\nVERDICT: ❌ \nFalse\n\nEXPLANATION: 🔍\nThe claim that \"The Earth is flat\" is false. There is overwhelming scientific evidence that the Earth is approximately spherical (technically an oblate spheroid). This has been confirmed through multiple lines of evidence including:\n\n1. Photographs from space showing Earth's curvature\n2. Circumnavigation of the Earth\n3. The way ships disappear hull-first over the horizon\n4. Time zone differences\n5. The curved shadow of Earth during lunar eclipses\n6. Gravitational measurements\n7. GPS satellite operations that account for Earth's shape\n\nCORRECTIONS: 📝\nThe Earth is not flat but is an oblate spheroid (a sphere slightly flattened at the poles and bulging at the equator). Its shape has been well-established by scientific observations and measurements for centuries.\n\nDo you want to save this fact-check result? (y/n): 💾 y\n\nResult saved to: fact_check_results/fact-check-The-Earth-is-flat-1710618360.txt ✅\n\nDo you want to fact-check another statement? (y/n): 🔄 n\n\nThank you for using the Fact Checking Assistant. Goodbye! 👋\n```\n\n## How It Works\n\n1. The program takes user input for claims to verify\n2. It sends the claim to Perplexity AI with a specialized prompt for fact-checking\n3. The AI response is parsed to extract the verdict, explanation, and corrections\n4. Results are displayed with color-coding for easy interpretation\n5. Users can save results to text files for future reference\n\n## Requirements\n\n```\nopenai==0.28\npython-dotenv\ncolorama\n```\n\n## Video Demo\n\nA video demonstration of Truth Seeker is available [here](https://drive.google.com/file/d/1C7lit2uCIwIQIRZBzzPH-iRRCcyMG7Al/view?usp=sharing).\n\n\n## License\n\nAll rights reserved.\n\n---\n\nMade by Yasharth Bajpai  \n© 2025\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyasharthbajpai%2Ftruth-seeker-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyasharthbajpai%2Ftruth-seeker-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyasharthbajpai%2Ftruth-seeker-python/lists"}