{"id":23571663,"url":"https://github.com/william-fernandes252/lucaria","last_synced_at":"2026-04-12T10:45:42.653Z","repository":{"id":269709035,"uuid":"908065312","full_name":"William-Fernandes252/lucaria","owner":"William-Fernandes252","description":"A platform for creating, sharing and solving quizzes using generative AI.","archived":false,"fork":false,"pushed_at":"2025-01-12T20:09:18.000Z","size":121,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-21T11:02:41.089Z","etag":null,"topics":["ai","aisdk","biomejs","effect-ts","generative-ai","llm","nextjs","prisma","react","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/William-Fernandes252.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-12-25T03:10:57.000Z","updated_at":"2025-02-28T12:24:48.000Z","dependencies_parsed_at":"2025-02-17T21:49:36.574Z","dependency_job_id":null,"html_url":"https://github.com/William-Fernandes252/lucaria","commit_stats":null,"previous_names":["william-fernandes252/lucaria"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/William-Fernandes252%2Flucaria","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/William-Fernandes252%2Flucaria/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/William-Fernandes252%2Flucaria/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/William-Fernandes252%2Flucaria/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/William-Fernandes252","download_url":"https://codeload.github.com/William-Fernandes252/lucaria/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254513119,"owners_count":22083513,"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","aisdk","biomejs","effect-ts","generative-ai","llm","nextjs","prisma","react","typescript"],"created_at":"2024-12-26T20:18:58.246Z","updated_at":"2025-12-30T23:04:57.319Z","avatar_url":"https://github.com/William-Fernandes252.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lucaria\n\nA platform for creating, sharing and solving quizzes using AI.\n\n## Table of Contents\n\n- [Introduction](#lucaria)\n- [Requirements](#requirements)\n- [Getting Started](#getting-started)\n- [Docker](#docker)\n\n## Introduction\n\nLucaria is an innovative platform designed to harness the power of artificial intelligence for creating, sharing, and solving quizzes. By leveraging advanced AI models, Lucaria can generate structured quizzes from a variety of user inputs, making it a versatile tool for educators, trainers, and quiz enthusiasts.\n\nWith Lucaria, users can:\n\n- Create quizzes effortlessly using AI-generated questions.\n- Share quizzes with others and track their performance.\n- Solve quizzes created by others and receive instant feedback.\n\nWhether you're looking to test your knowledge, create engaging learning experiences, or simply have fun, Lucaria provides the tools you need to make it happen.\n\n## Requirements\n\nThis project uses Next.js 15 and React 19. In order to run it locally, make sure to have installed\n\n- Nodejs `v22.9.0`\n- pNpm `v9.7.0`\n\n## Getting Started\n\nLucaria leverages [Vercel's AI SDK](https://sdk.vercel.ai/docs/introduction#ai-sdk) capabilities to apply [Large Language Models](https://en.wikipedia.org/wiki/Large_language_model) for generating structured quizzes from different kinds of user inputs.\n\nTo run, test and develop in your machine, it is necessary to have a model server available for the application.\n\nIf you followed the instructions to use [Docker] for the development environment, you already have a [Ollama](https://ollama.com/) container running. Otherwise, follow [these instructions](https://github.com/ollama/ollama) to run Ollama locally.\n\nNow, in order to run the project in development mode, execute\n\n```bash\npnpm dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) with your browser to see the result.\n\n## Tests\n\nTo run the tests for the Lucaria project, you can use the scripts defined in the `package.json` file. Follow these steps:\n\n1. Ensure you have all dependencies installed:\n\n```bash\npnpm install\n```\n\n1. Run the tests:\n\n```bash\npnpm test:unit\n```\n\nThis will execute the test suite and provide you with the results in the terminal.\n\nFor coverage reports, run:\n\n```bash\npnpm coverage\n```\n\nThese commands will help you ensure that your code is functioning correctly and maintain high code quality.\n\n## Docker\n\nThe repository includes a [Compose file](https://docs.docker.com/compose/) to set up a development environment using Docker. In order to use it, follow these steps:\n\n1. Ensure you have Docker and Docker Compose installed on your machine.\n\n1. Set the Compose file for the environment:\n\n```bash\nexport COMPOSE_FILE=docker-compose.development.yml\n```\n\n1. Build and start the containers:\n\n```bash\ndocker compose up --build\n```\n\nTo stop the containers, run:\n\n```bash\ndocker compose down\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwilliam-fernandes252%2Flucaria","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwilliam-fernandes252%2Flucaria","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwilliam-fernandes252%2Flucaria/lists"}