Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/netguru/carlens-ios
CarLens - Recognize and Collect Cars
https://github.com/netguru/carlens-ios
arkit car car-recognition cars coreml image-recognition ios ios-app lottie lottie-ios machine-learning machinelearning swift swift4 vision
Last synced: 6 days ago
JSON representation
CarLens - Recognize and Collect Cars
- Host: GitHub
- URL: https://github.com/netguru/carlens-ios
- Owner: netguru
- License: apache-2.0
- Created: 2018-05-29T09:54:19.000Z (over 6 years ago)
- Default Branch: develop
- Last Pushed: 2022-07-22T02:12:17.000Z (over 2 years ago)
- Last Synced: 2024-04-09T21:43:47.886Z (7 months ago)
- Topics: arkit, car, car-recognition, cars, coreml, image-recognition, ios, ios-app, lottie, lottie-ios, machine-learning, machinelearning, swift, swift4, vision
- Language: Swift
- Homepage: https://www.netguru.co/carlens
- Size: 135 MB
- Stars: 129
- Watchers: 14
- Forks: 19
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CarLens
[](https://itunes.apple.com/us/app/carlens/id1417168518?mt=8)
**CarLens** is a mobile app that uses **Augmented Reality** and **Machine Learning** to detect different car models. It connects to your smartphone camera and enables you to verify cars around as you walk on the streets.
We currently support the newest versions of 4 cars in CarLens:
* Honda Civic
* Ford Fiesta
* Nissan Qashqai
* Volkswagen Passat
Discover **car recognition** together with CarLens!
## Tools & Frameworks
* Tools:
* Xcode 10.1 with latest iOS stable SDK (12.0) and Swift 4.2
* [Carthage](https://github.com/Carthage/Carthage) 0.29 or higher
* [CocoaPods](https://github.com/CocoaPods/CocoaPods) 1.5 or higher
* Frameworks:
* [Core ML](https://developer.apple.com/documentation/coreml)
* [ARKit](https://developer.apple.com/arkit/)
* [Vision](https://developer.apple.com/documentation/vision)
* [Lottie](https://github.com/airbnb/lottie-ios)
* [SwiftLint](https://github.com/realm/SwiftLint)
## Configuration
### Prerequisites
- [Bundler](http://bundler.io) (`gem install bundler`)
- [Homebrew](https://brew.sh)
- [Carthage](https://github.com/Carthage/Carthage) (`brew install carthage`)
- [CocoaPods](https://cocoapods.org) (`brew install cocoapods`)
### Instalation
1. Clone repository:
```bash
# over https:
git clone https://github.com/netguru/CarLens-iOS
# or over SSH:
[email protected]:netguru/CarLens-iOS.git
```
2. Install required Gems:
```bash
bundle install
```
3. Run Carthage:
```bash
carthage bootstrap --platform iOS --cache-builds
```
4. Rename `.env.sample` to `.env`.
5. Install pods through Bundler:
```bash
bundle exec pod install
```
6. Open `CarLens.xcworkspace` file and build the project.
## CarLensCollectionViewLayout
As a part of CarLens we've launched another open source tool - **CarLensCollectionViewLayout**. Its an easy-to-use Collection View Layout for card-like animation 🎉. [Make sure to check it out too!](https://github.com/netguru/CarLensCollectionViewLayout)
## About
This project is made with ❤️ by [Netguru](https://netguru.co) and maintained by [Anna-Mariia Shkarlinska](https://github.com/anyashka).
### License
*CarLens* is licensed under the Apache License. See [LICENSE](LICENSE) for more info.
### Contribution
All contributions are welcome! Feel free to create issues and PRs. Please, respect the following coding guidelines:
- Respect Swift [API Design Guidelines](https://swift.org/documentation/api-design-guidelines/)
- The code must be readable and self-explanatory - full variable names, meaningful methods, etc.
- Don't leave any commented-out code.
- Write documentation for every method and property accessible outside the class. For example, well-documented method looks as follows:
```swift
/// Tells the magician to perform a given trick.
///
/// - Parameter trick: The magic trick to perform.
/// - Returns: Whether the magician succeeded in performing the magic trick.
func perform(magicTrick trick: MagicTrick) -> Bool {
// body
}
```
### Read More About CarLens
- [How We Built CarLens](https://www.netguru.com/blog/machine-learning-and-augmented-reality-combined-in-one-sleek-mobile-app-how-we-built-car-lens)
- [Increasing the Accuracy of the Machine Learning Model in CarLens](https://www.netguru.com/blog/improving-machine-learning-model-carlens-case-study)
### Related Links
- [CarLens Page](https://www.netguru.com/carlens)
- [CarLens in App Store](https://itunes.apple.com/us/app/carlens/id1417168518?mt=8)
- [CarLens Android - repository](https://github.com/netguru/car-recognition-android)
- [CarLens on Google Play](https://play.google.com/store/apps/details?id=co.netguru.android.carrecognition&hl=en)
- [CarLensCollectionViewLayout - repository](https://github.com/netguru/CarLensCollectionViewLayout)
- [CarLensCollectionViewLayout - article](https://www.netguru.com/codestories/introducing-carlenscollectionviewlayout-a-new-open-source-ios-tool-by-netguru)